// manual
The Shuvarie manual
20 pages of reference for the agent, the prompt, the session tree and every KDL file it reads. Written in markdown and compiled with mdsvex — Svelte's MDX — so pages can embed components; code blocks are highlighted at build time and this whole page is static.
01Start here → Install
Get the shuvarie binary with Nix or Cargo, then survive the first run.
Getting started 1
Usage 7
- Usage The day-to-day loop: run shuvarie in a project and work from the prompt.
- Command line & the prompt Invocation flags, headless `shuvarie run`, and how the input line behaves.
- Slash commands Every `/command`, when it appears, and how to write your own.
- Keybindings Global, editing, streaming, scrolling and popup controls.
- Sessions Resume, fork, export and import a session tree.
- Workspace trust What Shuvarie may read out of your workspace, and how it remembers.
- Tabs Run several agents at once, each in its own workspace, and switch between them.
Configuration 12
- Configuration The KDL files that make Shuvarie yours.
- Configuration files Where `shuvarie.kdl`, `connections.kdl`, `themes.d` and friends live.
- Interface & themes Sidebar, notifications, image protocols and the theme system.
- Agent & context System prelude, context files and history compaction.
- Skills Reusable procedures in markdown, invoked as `/skill:<name>`.
- Tools & integrations The tool roster, MCP servers, stdio commands and concurrency.
- Codemode One tool that runs Rhai, and the script calls the rest.
- Attachments Attach documents and images with `/attach`; conversion and limits.
- Providers & models Every way to bind an LLM, plus peak/off-peak billing windows.
- Scenes Named bundles of system prelude, hooks and tool rosters — plus subagents.
- Permissions Allow, deny and ask: paths, shells, tools and trust.
- Decisions System One-style decision models that answer permission asks.