This website is a stub (mostly) generated by AI and built with Jekyll. A rewrite will be commenced in the near future.
An agentic AI pair-programmer that lives in your terminal. Shuvarie reads your code, edits files, runs tools and keeps a forkable history of every decision — all under explicit, granular permissions you control.
🔌 Bring your own model
OpenAI-compatible, Anthropic, Ollama and more — configured in one
connections.kdl, switchable on the fly with /model.
🌲 Sessions & forking
Every session is a tree. Inspect it with /tree, roll back
with /undo, replay, and export or import sessions as JSON.
🧩 Skills
Reusable prompts and procedures stored as markdown, invoked straight
from the prompt as /skill:<name>.
🎨 Scenes & themes
Built-in Advisor, Reviewer and
Orchestrator scenes, plus five theme families. Drop in
scene.d and themes.d files, switch live with
/scene.
📎 Attachments
Type @path to attach documents (pdf, docx, xlsx, epub,
…) or images; the model reads them through read_file.
🛡️ Permissions & trust
A workspace trust prompt on first run, plus a granular allow/deny
permissions section — optionally backed by decision
models. The agent never acts unbound.
⌨️ Keyboard-first
Every action has a keybinding, and Ctrl+M puts every
command one keystroke away.
🖥️ Headless mode
shuvarie run "…" drives the agent without the TUI,
streaming the reply to stdout and the tool log to stderr — the same
config, permissions and sessions.
Try it
# with Nix (flakes enabled)
nix run github:shuvarie/shuvarie # try it
nix profile install github:shuvarie/shuvarie # keep it
# or with a Rust toolchain, from a checkout
cargo install --path .
Then read the Install, Usage and Configuration pages.