Docs

What every part of Origami does and how to reach it. Each page is one thing, read in a minute.

Get started

• OverviewOrigami is a terminal manager that keeps each project's agents, shells, servers and pages together in one window.
• InstallDownload Origami, open it, and point it at your first project folder.
• The windowThe rail, the sidebar, the stage and the titlebar, and what each one is for.

Workspaces

• WorkspacesA workspace is a project folder and everything that runs in it.
• SidetrackA second sheet on the right that keeps a tab in view beside the one you work in.
• FilesA Sidetrack widget that shows the workspace's files beside your work, to read and to change a little.
• ScratchpadA page of notes for each workspace, kept in Sidetrack beside your work.
• SelectionPick several rows of the sidebar at once and start, stop or remove them together.

Tabs

• AgentsA coding agent running in a tab of its own, in the workspace's folder.
• TerminalsA shell in a tab, opened in the workspace's folder.
• CommandsA dev server or script saved as a tab, started and stopped with one key.
• BrowsersA real browser in a tab, beside your code, for you and your agents.

Keyboard

• Command paletteA search box for everything Origami can do, with a second one for jumping between tabs.
• ShortcutsThe keys that move you round Origami without the mouse.
• FindA search bar over a terminal that finds text anywhere in its output.
• UnfoldDescribe a command in plain words and get the shell command back on your prompt.

Agents

• Agent statusThe mark on an agent's tile that says whether it is working, waiting on you or done.
• Agent optionsThe flags and variables a built-in agent starts with, chosen from a list instead of typed.
• Agent updatesA toast that tells you when a newer release of one of your built-in agents is out, and updates it for you.
• NotificationsA word from Origami when an agent needs you or has made something for you.
• UsageWhat is left of your agents' plans, and what your agents have used.
• MCP serverThe way an agent works Origami the way you do, from opening a terminal to answering a review comment.
• Agent trailThe record of every call an agent made to Origami, and what each one changed.
• HandoffHand a card, your review comments or your annotations to a loop or an agent as a ready-made prompt.

Loops

• LoopsA conversation in which Origami drives your own installed agent through one piece of work.
• Loop worktreesA new loop works in the workspace's checkout, or in a worktree and on a branch of its own.
• AttachmentsWhat you hand a loop beside your words, from artifacts and cards to files, tabs and pictures.
• ModelsThe model a loop runs, how hard it thinks, how fast it runs, and which agent runs it.
• ModesHow far a loop's agent goes before it asks you.
• QueueMessages you send while the agent works, held until its turn ends.
• GoalsA goal that keeps a loop going, turn after turn, until the agent says it is met.
• RewindSay one of your messages again from where it was, with the files put back if you want.
• ForkA new loop that starts from everything said in another, then goes its own way.
• InstructionsYour own words for every loop's agent, and a look at everything a loop loads.
• SubagentsYour own helpers for a loop's agent, each running on one agent, model and effort.
• ServersYour own MCP servers for Claude Code, Codex and GitHub Copilot, and how each is doing in a loop.
• SkillsYour own skills for Claude Code, Codex and GitHub Copilot, managed in one place.
• HooksA command your agents run when something happens in their sessions.

Git

• ChangesThe git view's first page, where you read, stage and commit what has changed in a workspace's folder.
• CommitsThe branch's history in the git view, with each commit's details and files, and the button that pushes it.
• BranchesSwitch, create, rename and delete a workspace's branches from one page of the command palette.
• WorktreesChoose which checkout of a repository the git view works on, and add or remove worktrees.
• StashesPut uncommitted changes aside and bring them back later, from the git view.
• Review threadsComments pinned to lines of a diff, which you and your agents read, answer and resolve.
• Branch reviewEverything the current branch changes since it left its base, committed or not, as one diff.

Board

• BoardA kanban board for each workspace, which you and your agents keep together.
• CardsA piece of work on the board, with a key, a page of its own and a conversation under it.
• EpicsA card that gathers the stories, tasks and bugs of one larger piece of work.

Artifacts

• ArtifactsDocuments your agents publish to Origami, drawn as they are meant to be read and kept with every version.
• GroupsA name artifacts share, so the work that belongs together is found together.
• AnnotationsFeedback you pin on a version of an artifact, for an agent to address in the next one.

Setup

• AppearanceHow Origami looks, from its theme and its terminals' colours to the size of everything in it.
• StorageWhat Origami keeps on this computer, with ways to give the room back, move it elsewhere or start over.
• Export and importYour workspaces, boards, artifacts and settings saved to one file, to bring back later or onto another computer.
• Origami+The subscription that lifts the free limits on workspaces and the items in each.
• UpdatesOrigami keeps itself up to date, and shows what changed once it has.
• TroubleshootingFixes for the problems that come up most, and where to ask when they do not help.