CLI reference
tutti does from a terminal what an AI app does over MCP. Claude Code and Codex can use it as it is: point them at tutti help.
Edit this page on GitHubInstall and sign in
Terminal
$ npm i -g @darkmatter-ai/tutti$ tutti login --web # the hosted app$ tutti login --web --base-url https://tutti.example.com # your own server$ tutti whoami
--web opens the browser so you can pick which workspaces the CLI reaches. Without it, tutti login takes an API key.
Commands
Sign-in and modes
login [--web]Sign in with the browser, or paste a key
whoami · teams · logoutWhere you are signed in, and to which workspaces
use local · use remoteRun on this machine, or against the app
use team <id>The workspace commands act on
Workflows
workflows list · search · getFind and read workflows
workflows show <id>Draw a workflow as a tree of steps
workflows create · clone · scaffoldStart from JSON, a copy or a minimal skeleton
workflows validateCheck a workflow before you save it
workflows node patchChange one step and keep the rest
workflows versions · undoEarlier versions, and going back to one
Runs
run <id>Run a workflow and wait for the result
run-parallelRun several workflows at once
runs list · get · stepRecent runs, one run, one step's output
runs cancel · rerunStop a run, or start it again with the same input
Data
recordsPeople, companies and products in the CRM
tablesTeam database tables and their rows
kv · memoryThe key-value memory workflows share
files · foldersFiles, and the folders workflows sit in
Connections and the rest
integrations · connectorsThe apps your workflows can use
schedulesSwitch schedules on and off, change their times
templatesEmail templates, their versions and what was sent
actions search · schemaWhat each kind of step does and takes
keys · members · modelsYour API keys, your workspace's people, the AI models on offer
api <method> <path>Call any API route directly
Local mode only
secrets set · list · rmCredentials your steps read by name
schedule install · list · removeRuns from launchd or cron
serve · trust forgetStart runs over HTTP; take back a workflow's trust
Settings
For CI and sandboxes, skip login and set these. A flag wins over the environment, which wins over ~/.config/tutti/config.json.
| Setting | Flag | Environment |
|---|---|---|
| API key | --api-key | TUTTI_API_KEY |
| App address | --base-url | TUTTI_BASE_URL |
| Workspace | --team | TUTTI_TEAM_ID |
| Mode | --local · --remote | TUTTI_LOCAL=1 |
Output for scripts and agents
In a terminal you get tables. Piped or redirected, or with --raw, you get JSON on stdout and errors as JSON on stderr. Commands that delete something need --yes.
0Done
1The app or the run failed
2A usage or sign-in problem
Help
Terminal
$ tutti help # every command$ tutti help workflows # one command's flags