CLI & shortcuts
Two binaries: akili-code for the terminal, akili-code-ui for the desktop.
Commands
| Command | What it does |
|---|---|
akili-code | An interactive agent session in the current folder |
akili-code chat [path] | The same, starting somewhere else |
akili-code update | Install the current release, verified against its checksums |
akili-code inspect [path] | Summarise a repository — languages, structure, build commands |
akili-code symbols [path] | Structural symbols per file |
akili-code graph [path] | The file dependency graph |
akili-code related <file> | What a file depends on, and what depends on it |
akili-code context … | Build a ranked, budget-bounded context pack |
akili-code ask "…" | Answer a question about the codebase, citing files |
akili-code edit <file> "…" | Propose a reviewed diff; verify and self-heal |
akili-code verify [path] | Run the project's format/test/build ladder |
akili-code env | Host environment — shells, toolchains, containers |
akili-code run "…" | Run a command in a chosen shell, streaming output |
akili-code --version | Which build you are on |
Flags worth knowing on edit
--apply | Write the change rather than only proposing it |
--verify | Run the verification ladder afterwards |
--revert-on-fail | Put the file back if verification fails |
--repair[=N] | Read the failure and try again, up to N times |
--dry-run | Print the request instead of sending it |
In a session
Type /help for this list at any time; Tab completes a command.
| While working | |
|---|---|
/plan | the current task plan |
/continue | resume a paused run (/resume, /go) |
/retry | send the last message again |
/edit | change your last message in place, then resend |
/copy | copy the last answer to the clipboard |
/read | read the last answer out loud |
/say <text> | read something out loud |
/cd <folder> | work in another project (/open, /project) |
/diff | uncommitted changes with +/- counts |
/apps | background servers this project started |
/stop [pid|all] | stop them |
/new | start fresh — clears the run, the chat and the screen (/clear) |
| Surfaces | |
/chat | a conversation — it can read, never changes anything |
/build [task] | coding — add a task to switch and start |
/work [task] | documents, data, research — carries a chat over |
/motion [task] | code-native video |
| Account | |
/connectors | connect Google Drive and Gmail |
/whoami | who is signed in on this machine |
/login [email] | sign in — browser, or direct with an email |
/logout | forget the token on this machine |
/usage | tokens and spend this session |
/cost | spend this session |
| Setup | |
/voice | voices that read aloud — offline, no tokens. See Voice |
/model [name] | show or switch the model |
/provider [name] | show or switch the provider |
/cwd | the folder being worked in |
/help | this list |
/exit | leave (Ctrl-D also works) |
Small things that save typing
- When Akili ends with a question — “Want me to draft a reply?” — answer with just
yorn. /work write that up as a planswitches and starts. Coming from/chat, the conversation comes with you. See Chat./cd ~/other-projectmoves to another folder and resumes whatever session it had./copyputs the last answer on the clipboard, in its original Markdown./editbrings your last message back, already typed — fix a word and press Enter instead of retyping it.
Ctrl-C cancels a running agent turn without killing the session.
Desktop shortcuts
| Ctrl+P | Go to file (fuzzy) |
| Ctrl+B | Show or hide the explorer |
| Ctrl+J | Chat beside the editor, in the project window |
| Ctrl+W | Close the open file |
| Alt+1…9 | Go to a tab |
| Ctrl+PgUp / PgDn | Previous / next tab |
| Ctrl+S | Save |
| Ctrl+F / Ctrl+H | Find / find and replace |
| F3 / Shift+F3 | Next / previous match |
| Ctrl+G | Go to line |
| Ctrl+N / Ctrl+Shift+N | New file / folder |
| F2 / Del | Rename / delete the selected file |
| Esc | Close find, go-to-line or the file palette |
Paste a screenshot straight into the message box. Take a screenshot, click into the message box anywhere the composer appears — the Chat window or the panel beside the editor — and press Ctrl+V. It attaches with a thumbnail, so you can see which one you picked before sending. Files can also be dragged onto the window, or chosen with Attach.
Several files stay open. Opening a file adds a tab; unsaved work belongs to its tab, so moving between them keeps your edits, and a dot marks what is unsaved. Closing a tab with unsaved changes asks first.
The layout is remembered. Which panels are open and how wide come back the way you left them. The chat panel drags from narrow — where it keeps a message box and folds its controls behind ⚙ — to about half the window.
The chat panel is the same conversation as the Chat tab — ask a question without leaving the file you are editing, and keep editing while it answers. Switching project clears the editor, the diff, the problems and the output: they belonged to the folder you left. If a file has unsaved changes, you are asked before anything is discarded.
Cut, copy, paste, select all and undo are the usual Ctrl+X/C/V/A/Z, and are on the editor's right-click menu. Single-key shortcuts only fire when no text field has focus, so pressing Del while typing does not offer to delete a file.
Project configuration
An optional akili-code.toml at the project root sets defaults and can override the verification ladder. It is committed, so a team shares it.
[defaults]
model = "akili-core"
budget = 12000
[policy]
denied_tools = ["install_tool"]