Two ways in, same commands. Agents with a shell (Claude Code, Cursor, Codex) call statuz directly; apps without one, like Claude Desktop, use statuz mcp, which serves every command as a tool over stdio. The CLI reference lists them all.
Teach your agent
statuz initWrites AGENTS.md and the Statuz skill into ~/.statuz, then lists the agent apps it finds. Tick the ones that should use Statuz. Apps with a terminal get the skill in their own folder; apps without one get an MCP server in their config:
| App | Where |
|---|---|
| Claude Code | ~/.claude/skills |
| Codex, Zed, OpenHands | ~/.agents/skills |
| Cursor | ~/.cursor/skills |
| VS Code, Copilot CLI | ~/.copilot/skills |
| Windsurf | ~/.codeium/windsurf/skills |
| Gemini CLI | ~/.gemini/skills |
| OpenCode | ~/.config/opencode/skills |
| Amp | ~/.config/amp/skills |
| Goose | ~/.config/goose/skills |
| Cline | ~/.cline/skills |
| Kilo Code | ~/.kilo/skills |
| Factory Droid | ~/.factory/skills |
| Qwen Code | ~/.qwen/skills |
| Crush | ~/.config/crush/skills |
| Warp | ~/.warp/skills |
| Junie | ~/.junie/skills |
| Mistral Vibe | ~/.vibe/skills |
| Kimi Code | ~/.kimi-code/skills |
| Qoder | ~/.qoder/skills |
| Pi | ~/.pi/agent/skills |
| Letta Code | ~/.letta/skills |
| Trae | ~/.trae/skills |
| Claude Desktop | MCP server in claude_desktop_config.json |
| LM Studio | MCP server in ~/.lmstudio/mcp.json |
| Jan | MCP server in mcp_config.json |
| AnythingLLM | MCP server in anythingllm_mcp_servers.json |
| BoltAI | MCP server in ~/.boltai/mcp.json |
Some apps also read other apps' folders (Cursor reads ~/.claude/skills), so ticking several can show the skill twice. Nothing already there is overwritten. Untick an app to disconnect it, or use statuz agents list | add | remove.
Tool names
Command id with dots turned into underscores. Inputs match the flags, in camelCase.
| CLI | MCP tool |
|---|---|
statuz posts create | posts_create |
statuz posts list | posts_list |
statuz accounts list | accounts_list |
statuz status | status |
Try it
Connect an account (Accounts), run statuz start, then ask:
Schedule a week of launch posts: one a day at 9am, Monday to Friday, to X and Bluesky. Under 280 characters each. Show me the list first.
More prompts:
- "What's scheduled for next week?"
- "Move Thursday's post to Friday at 10."
- "Anything failed? Retry it."
- "Open my post for Monday."
Posts too long for a destination are rejected before saving, and the agent sees why.
Open in the app
statuz open --post <id> (or --page queue) shows it in the Mac app when it's installed, else on statuz.cloud for Cloud's posts. An agent on Statuz Cloud gets the link to hand you instead.
Read and write
Every command is read or write; the CLI reference marks each. On Statuz Cloud, an API key has its own role: viewer (reads), member (also writes posts and connects accounts) or admin (also runs the team and settings). There are no owner keys, so no key reaches billing, and a key never does more than its creator can today. Make one with statuz cloud keys create --label CI --role member; revoke it from the API keys page or statuz cloud keys revoke.
Local or Cloud
Agents follow the target: statuz use local or statuz use cloud.