Known Issues
This page lists known issues that may affect your experience with ai-skills. Most are caused by upstream dependencies and are tracked accordingly.
This known issue has been resolved since 2.7.0.
Multi-Choice List Rendering
When ai-skills displays an interactive multi-choice list — used in commands like install, list, read, remove, sync, and search — the list may render incorrectly if there is not enough vertical space below the cursor in your terminal.
This is a display-only issue. ai-skills itself continues to work correctly — your selections, installs, and other operations are unaffected. Only the on-screen rendering looks wrong.
When it happens: The bad rendering is triggered when an error message is displayed below the multi-choice list — for example, when you press Enter without selecting anything and the prompt shows Please select at least one, or press Ctrl+C to cancel. If no error message ever appears, the list renders correctly.
Cause: This is an upstream issue in the cue4s library, tracked at neandertech/cue4s#58.
Workaround: Clear the terminal first and start using ai-skills from a freshly cleared screen. Common shortcuts to clear:
- macOS (iTerm2 / Terminal.app):
Cmd+K - Linux / Windows terminals:
Ctrl+L(or runclear)
If you still see the issue, also increase your terminal window height so there is enough empty space below the prompt.