Subroutine command line

Every command subroutine answers to in this release, as its own help describes it.

subroutine [OPTIONS] COMMAND [ARGS]...

A self-hosted, agent-native task and decision tracker for people and coding agents working on complex projects.

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 export - Take away your work on one connection, as files you can keep.
• 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 view - Save a narrowing under a name, and come back to it.
• subroutine connections - List the instances this reaches, which one you are working in, and where each one's token came from.