# Canvass for agents | Install the Canvass CLI

Canonical: https://canvass.fabric.pro/agents/

Canvass for agents

Give your agent governed access to Canvass.

Connect Claude, Codex, Grok, or Hermes to your workspace with the Canvass CLI. Your agent can research accounts and prepare campaigns using the permissions and approvals you choose.

Then run . It diagnoses your machine and points you to the approved workspace connection flow.

Quick start

From install to a useful first command.

Install

Download the signed release for your operating system and architecture.

Set up

Run to diagnose the machine and open the next connection step.

Connect

Create a pairing code in Canvass, then run . Approval stores the credential in your system keychain.

Add your agent

Run , , and . Then call .

Put an agent to work

Start with the outcome you want.

Your agent can discover the commands and permissions available to its registration.

Prepare account research

Review launch readiness

Monitor replies

Let your agent prepare the work. Review the decisions that need you.

Access without a bypass

The CLI follows the same rules as the product.

Your agent can

Your agent cannot

Before you install

Common questions.

Which agents work with the CLI?

Any agent that can run terminal commands and read structured JSON can use it. Claude Code, Codex, Grok, Hermes, and similar tools are supported operating patterns.

Does setup give an agent my full account access?

No. Setup connects one approved, tenant bound registration. The server rechecks its tools, actions, campaign scope, expiry, and approval policy for every request.

Can an agent send email automatically?

Only through the governed campaign path and only when the current authorization, audience safety, launch readiness, and human approval rules allow it. Dry runs never activate a provider campaign.

What about Windows?

Use the PowerShell installer from the CLI reference. The release includes Windows binaries and the same checksum verification.

Ready for your agent

Connect your agent to Canvass.

Read the CLI reference for Windows, pinned versions, updates, and troubleshooting.