Skip to main content
Sonto for Mac ships with sonto, a small command-line tool for reading and editing your tasks, plans and projects from a terminal. It’s handy on its own, and it’s the most efficient way to give a coding agent like Claude Code access to Sonto — a CLI call costs far fewer tokens than a full MCP tool set.
The CLI runs on Mac only. It needs Sonto running with AI Access on (Settings → AI) — which is the default.

​
Install

The tool is bundled inside the app, as sontocli. To run it as sonto from anywhere, link it onto your PATH. Open a terminal and type:
The path changed in Sonto 2.0. The bundled tool used to be called sonto, which clashed with the app’s own binary on a case-insensitive disk. If you linked it before 2.0, remove the old link and run the command above again:
The exact path is shown in Settings → AI → Use the CLI or connect to other AI Agents, as CLI Path, with a Copy button.
Check the connection:

​
Everyday commands

Every command accepts --json for machine-readable output.

​
Any tool, by name

sonto tools lists every tool the server exposes, and sonto call runs any of them directly — handy for tools without a dedicated command:
See Connect to AI Agents for the full list of tools.

​
Read vs allow changes

The CLI honours the Allow changes toggle in Settings → AI. With it off (the default), read commands work and any write is rejected. Turn it on to let sonto add and the other write tools through.

Connect to AI Agents

Connect Claude Desktop, Claude Code, Codex and others.

Using AI with Sonto

The guided walkthrough.