Subroutine command line

Every command subroutine answers to at the pinned commit, as its own help describes it.

subroutine [OPTIONS] COMMAND [ARGS]...

Agent-native task management for complex projects, where the decisions live beside the work.

Examples:

subroutine add "Call the dentist before Sunday"

subroutine agenda

subroutine done 1

subroutine explain dates

Run with no arguments, this shows today's agenda.

Options

--workspace / -w (str): Which workspace this command is about.
--connection / -c (str): Which instance this command is about.
--profile (str): Act on a separate installation on this machine, by name.
--version (flag): Print the installed version and the schema it expects.

Commands

subroutine add - Add something to your list.
subroutine agenda - Show what you are doing today, or what another day looks like.
subroutine today - Say where this went.
subroutine list - List everything still open — tasks and documents — newest first.
subroutine search - Find things by any of their words, wherever they were written.
subroutine journal - What happened over a period, with who did it and what they said.
subroutine changes - What has changed, oldest first — the question to ask after time away.
subroutine ls - The short name for 'subroutine list'.
subroutine show - Read one item — what it is, what it is joined to, and what happened to it.
subroutine claim - Take something, so nobody else starts it too.
subroutine release - Put something back, so somebody else can pick it up.
subroutine verify - Record what you checked against something, so the next person can see it.
subroutine start - Say you have started something.
subroutine stop - Say you have put something down again, without finishing it.
subroutine done - Tick something off.
subroutine skip - Let one of a repeating task go by, and bring the next.
subroutine plan - Say which day you will do something.
subroutine defer - Hide something until later.
subroutine move - Make something part of another item, or a top-level item again.
subroutine update - Change what a task says about itself.
subroutine comment - Record what happened against an item.
subroutine uncomment - Take a comment back out of an item's record.
subroutine link - Say how two items are related.
subroutine unlink - Undo a link between two items.
subroutine delete - Take something off the list that should not have been on it.
subroutine restore - Put something back that was deleted.
subroutine use - Choose what a bare task number means.
subroutine whoami - Which account this machine is acting as, and what it is allowed to do.
subroutine init - Set up Subroutine: create the database and everything a first task needs.
subroutine mcp - Serve this instance to an AI agent over MCP, on stdin and stdout.
subroutine serve - Serve the HTTP API.
subroutine upgrade - Say where this went.
subroutine help - Show what this can do — the same as 'subroutine --help'.
subroutine explain - Explain a concept — refs, dates, the capture grammar, scripting.
subroutine doctor - Say whether this machine's installation is coherent, and change nothing.

Command groups

subroutine config - Inspect and manage configuration.
subroutine db - Look after the database.
subroutine token - Issue credentials for agents and other machines.
subroutine agent - Set an AI agent up as a principal of its own.
subroutine calendar - Subscribe a calendar application to your work.
subroutine login - Let somebody sign in to the web interface.
subroutine profile - Keep separate installations on one machine.
subroutine document - Write down what you concluded.
subroutine project - Group work into projects.
subroutine instance - Look after this installation itself.
subroutine workspace - Look after the spaces work is kept in.
subroutine setup - Wire Subroutine into the tools on this machine.
subroutine user - Add the people and agents this instance is for.
subroutine connections - List the instances this reaches, which one you are working in, and where each one's token came from.