Project-first agent workspace

Aya

A desktop home for long-lived Claude Code, Codex, Aider, and shell sessions. Keep real PTYs alive, grouped by project, with usage, snippets, diffs, and agent status close at hand.

Download v0.7.7 See workflows

Projects Switch repos without killing terminals.

Agents Claude, Codex, Aider, Gemini, shell.

Local Interactive PTYs, no proxy layer.

Aya desktop app showing terminal sessions organized by project

01 Open each repo as a project workspace.

02 Keep agent terminals alive across context switches.

03 Track usage, snippets, diffs, and waiting states.

04 Use one local CLI side channel for agent status.

Usage plans where you can see them.

Claude and Codex usage chips sit in the top bar. Aya reads local usage snapshots and rollout logs; it does not proxy provider APIs or read Anthropic tokens.

Top-bar percent for quick scanning.
Account rows for work and personal limits.
Stale data dims instead of pretending to be live.

Aya top bar showing Claude and Codex usage chips with the Claude account-wide popover open

Aya snippets drawer open below a terminal with saved prompt snippets

Snippets without spending agent context.

Save the prompts and commands you reuse every day, then inject them into the active terminal. They live in Aya, not inside the model conversation.

Type-only snippets for editable prompts.
Run-on-send snippets for commands.
Bracketed paste keeps multi-line snippets intact.

Diffs stay attached to the project.

Aya keeps the active branch and changed-file context visible around the agent terminal, so review loops stay grounded in the repo you are actually working in.

Dirty-file counts in the project status area.
Diff context for reviewing agent edits.
Project tabs keep unrelated repos separated.

Aya status bar diff popover showing changed files and highlighted additions and deletions

Terminal-native from every side.

The aya helper opens projects from any shell, focuses the desktop app, and lets agent harnesses report status without scraping provider state.

~/Projects/aya

$ aya .
opens this repo as a project

$ aya status waiting "Needs approval"
marks the active agent as waiting

$ aya notify --title "Aya" "Tests passed"
sends a desktop notification from the current pane

Install Aya.

Download the latest release for macOS Apple Silicon or Linux x64. The macOS DMG and zip are Developer ID signed and Apple-notarized; Linux ships AppImage and deb.

Download v0.7.7

# or build from source
git clone https://github.com/khasinski/aya.git
cd aya
npm install
npm run package