Overview

The Plot CLI lets you read and update your Plot workspace from a terminal. You can use it yourself, in scripts, or with AI agents that can run shell commands.

Use it to look up tasks, check project status, search workspace context, leave comments, create documents, and keep work moving without opening the web app.

plot task me
plot task get ENG-042
plot search "launch checklist"
plot comment add --entity task --id ENG-042 --body "Ready for review."

How It Works

The CLI connects to the same workspace your team uses in Plot. When you update a task, add a comment, or create a document from the CLI, the change appears in Plot with normal activity history and attribution.

Most read commands return JSON by default, so the output is easy for scripts and AI agents to use. You can also ask for Markdown when you want something easier to read in a terminal.

plot project summary checkout-redesign-a1b2c3d4e5f6 --format markdown

Common Uses

• Check what is assigned to you.
• Read a task before starting work.
• Search past tasks, docs, projects, comments, and team context.
• Update task status, assignee, labels, dates, and dependencies.
• Add comments so progress and decisions stay attached to the work.
• Create shared docs for plans, PRDs, briefs, notes, and handoffs.
• Let an AI agent work from the same team context you use in Plot.

Next Steps

• Install and authenticate the CLI
• Configure output, credentials, and updates
• Browse available commands
• Set up AI agents