Astrocode — Development skill for Claude Code

astrocode

Our own version of `claude`: Claude Code's engine with a terminal front end of our own, built on the [Claude Agent SDK](https://code.claude.com/docs/en/agent-sdk/overview).

The SDK runs the Claude Code binary, so astrocode uses the same login as `claude`, which is your Claude subscription. It also loads the same settings, CLAUDE.md files, skills, plugins, hooks and MCP servers. Only the interface is ours.

Run it

cd ~/Projects/astrocode && bun install
alias astrocode='bun ~/Projects/astrocode/src/cli.ts'   # add to ~/.zshrc

Then, in any project folder:

astrocode                 # start a session here
astrocode -c              # continue the most recent session here, with its history on screen
astrocode -r          # resume a session; astrocode prints the id when you exit
astrocode -m opus         # pick the model
astrocode -e high         # pick the effort
astrocode -f              # full screen, with the mouse

Sessions are saved where Claude Code saves its own, so `claude --resume ` opens an astrocode session too, and `/resume` in astrocode lists sessions from both.

Keys

Key	What it does
Enter	Send
Shift+Enter, Alt+Enter, Ctrl+J, or \ then Enter	New line
/	Command menu: ↑↓ to choose, Tab to complete, Enter to run
@	File menu: type part of a path, then Tab or Enter to put it in your message. A folder opens on what's in it
Esc	Stop Claude. Twice on an empty box: rewind to an earlier message
Shift+Tab	Change the permission mode: ask first, accept edits, plan, auto, bypass permissions
Alt+P	Switch the model (↑↓) and its effort (←→) in one picker
Alt+T	Turn thinking off or on, on models that can stop thinking. Current models always think, and effort sets how much
Alt+O	Fast mode on or off: Opus with faster output, for this session, where your plan has it
Alt+W	With ultracode in the message, keep it from starting a workflow this time