Docs

Quickstart

Launch Empryo, build the live code graph, and run your first AST-backed refactor in five minutes. Ask, rename a symbol, lint, and commit from the terminal.

1
Launch
```
cd your-project
empryo
```
The first launch scans your codebase to build a live graph (a few seconds). Press Ctrl+L to pick a model.
2
Ask something
Type any question. The agent already knows your file layout.
```
> what does the auth middleware do?
```
3
Make a change
Describe the change in plain English.
```
> rename UserService to AccountService across the project
```
Watch the agent run rename_symbol - one tool call updates every file.
4
Commit
Press Ctrl+G, then c. Empryo writes the commit message and runs lint + typecheck before committing. Or just say:
```
> commit my changes
```

Essential shortcuts

Key	Does
`Ctrl+L`	Switch model
`Ctrl+E`	Toggle editor panel (Neovim)
`Ctrl+G`	Git menu
`Ctrl+K`	Command palette
`Ctrl+B` / `Ctrl+F`	Browse prev / next checkpoint
`Ctrl+X`	Stop the agent
`Ctrl+T` / `Ctrl+W`	New tab / close tab

Common tasks

Rename & refactor

Rename a symbol across every file with one prompt.

Test, lint, commit

Run your toolchain through the agent.

Use multiple models

Cheap model for search, strong model for code.

Headless mode for scripts and pipelines.

Reach it from your phone [experimental]

Hearth - Telegram or Discord. (Experimental - expect rough edges.)

Connect MCP servers

GitHub, Sentry, anything MCP.

Next

Browse the recipes for copy-paste workflows.
Skim commands - type / to see them all in the app.
Tune ~/.empryo/config.json - see configuration.