Shortcuts and commands

The TUI is the primary entry point. Key bindings are listed by panel below; a CLI cheat sheet appears at the end (for scripting / CI).

Global key bindings

Key	Action
`tab` / `shift+tab`	Cycle panels
`h` / `l`	Jump left / right
`,`	Open settings
`?` / `f1` / `ctrl+/`	Help
`q` / `ctrl+z`	Confirm exit (`y` / `n`)
`ctrl+c`	Quit immediately

The settings panel (,) configures: theme, language, Registry URL / branch / protocol, SSH key path, HTTPS token.

The Skills, Contexts, and MCP panels share these navigation keys:

Key	Action
`enter`	Toggle list / detail focus
`esc`	Return to list
`↑` / `k`	Up
`↓` / `j`	Down
`pgup` / `b` / `ctrl+b`	Page up
`pgdown` / `f` / `ctrl+f` / `space`	Page down
`g` / `home`	Top
`G` / `end`	Bottom

Skills panel

Key	Action
`/`	Search
`1`	Filter: all
`2`	Filter: installed
`3`	Filter: available
`4`	Filter: outdated
`5`	Filter: broken
`6`	Filter: env-missing
`i`	Install
`u`	Update
`r`	Remove (confirm `y` / `n`)
`s`	Sync skills & env
`U`	Bulk update
`e`	Jump to Env panel

Contexts panel

Key	Action
`a` / `s`	Activate or switch (confirm `y` / `n`)
`u`	Update current Context (confirm `y` / `n`)
`r`	Deactivate current Context (confirm `y` / `n`)
`e`	Jump to env variables

MCP panel

Key	Action
`i`	Install
`u`	Update (confirm `y` / `n`)
`r`	Remove (confirm `y` / `n`)
`s`	Sync
`e`	Jump to env variables

Ops panel

The Ops panel lays out action entry points in a grid.

Key	Action
`←` / `→`	Move horizontally
`↑` / `↓`	Move vertically
`1`..`9`	Select by index
`enter`	Execute selected

Actions

Action	Description
Initialize Project	Equivalent to `aic init`
Sync Skills and Env	Equivalent to `aic sync`
Check for Updates	Check registry for new versions
Update All Skills	Update all installed Skills
Enable / Disable Shared Links	Toggle Link mode (shared / isolated)
Clean Project AIC Artifacts	Remove links and managed files aic created in the project (confirm `y` / `n`)
Check Environment	Equivalent to `aic env check`
Edit Project Env	Open project-level `.aic/.aic-env` editor
Edit Global Env	Open global `~/.aic/aic-env` editor

Env panel

Key	Action
`a`	Add variable
`o` / `e` / `enter`	Edit selected variable (adds new if none selected)
`c`	Check environment
`r`	Refresh

Permission panel

Permission preset management (covers Claude / Codex / Gemini / OpenCode).

Key	Action
`e` / `enter`	Edit permission file
`i` / `I`	Init baseline
`r` / `R`	Reset to baseline (confirm `y` / `n`)
`v` / `V`	Toggle relative / absolute path display

Provider panel

The Provider panel has sub-tabs per tool (Claude / Codex / Gemini / OpenCode).

Key	Action
`←` / `→`	Switch tool sub-tabs
`e`	Edit current profile
`o`	View config (read-only)
`c`	Copy config
`enter` / `s`	Switch Provider (confirm `y` / `n`)

CLI cheat sheet

CLI is an auxiliary path, mainly for scripting, remote environments, and CI integration. For everyday use we recommend the TUI.

Global / TUI

aic                # Enter the unified TUI (after TTY detection)
aic tui            # Explicitly enter the TUI
aic list           # List installed Skills (TTY mode enters the TUI)
aic list --available  # Plain-text list of Skills available in the Registry

Skills

aic install <skill>[@version]
aic update [skill][@version]
aic remove <skill>
aic sync

Context

aic context list
aic context show <name>
aic context current
aic context use <name> [--version X.Y.Z]
aic context update
aic context remove
aic context preview <name>

MCP

aic mcp list
aic mcp install <name> [--version X.Y.Z]
aic mcp update <name>
aic mcp remove <name>
aic mcp sync

Env

aic env list --scope merged
aic env add <KEY> --scope project
aic env edit --scope project|global
aic env promote <KEY>
aic env check

Exit codes

Code	Meaning
`0`	Success
`1`	Generic failure (parse error, IO error)
`2`	User input validation failure (missing required variable, invalid argument)
`3`	Network failure (Registry unreachable, token expired)

Note: exit codes are not surfaced directly to users in TUI mode. In CI, capture them with aic ... ; echo $?.

Commands that do not exist

These commands are not present in aic v1.0.x:

aic doctor / aic doctor --explain
aic init --template
aic config
aic login