Conduct AI

conduct-cli

Official CLI for Conduct AI — install AI agents, manage projects, run end-to-end tests, and enforce team AI policies with ConductGuard.

Runs on Linux, macOS, and Windows. Python 3.9–3.12.

Install

pip install conduct-cli

Quick start

# Authenticate (one-time)

conduct login \ --server https://api.conductai.ai \ --token cond_agt_xxx \ --workspace

Browse available agents

conduct playbooks

Create a project and install all agents in one shot

conduct install-all --project DevOps --repo owner/repo

List installed agents

conduct agents

Run a test trigger on any agent

conduct test "PR Reviewer" conduct test --all

Commands

Authentication

Generate an agent token from Settings → Agents → Issue token in the Conduct AI dashboard. Tokens start with cond_agt_ and are stored as SHA-256 hashes — the plaintext is shown only once.

conduct login --server https://api.conductai.ai --token cond_agt_xxx --workspace <id>

Install all agents

# Installs all 12 playbooks into a project, pointed at your GitHub repo

conduct install-all --project DevOps --repo myorg/myrepo

If the project doesn't exist it's created automatically. Use --input key=value to override any playbook input.

Test agents

# Test a single agent (fires synthetic test payload, streams run events)

conduct test "Autopilot Quick"

Test all playbook-based agents in sequence

conduct test --all

Exit code is 0 if all pass, 1 if any fail — works in CI.

---

ConductGuard

ConductGuard is AI tool fleet management — your security team sets policies once and they're enforced automatically across every developer's Claude Code, Cursor, and Windsurf session.

How it works

Admin configures policies and budgets in the Guard dashboard

└─ developers are workspace members automatically — no invite step needed

Developer runs: conduct guard sync ├─ pulls latest policy to ~/.conductguard/policy.json ├─ writes PreToolUse hook → ~/.conductguard/hook.py ├─ registers hook → ~/.claude/settings.json └─ registers conductguard-mcp → ~/.claude/settings.json (mcpServers) + Codex

Every Claude Code tool call: ├─ PreToolUse hook fires (hook.py) → checks policy → block / warn / audit └─ Event posted async to ConductGuard API → visible in Activity feed

Developer setup

pip install conduct-cli

Authenticate (already done if you use Conduct)

conduct login --server https://api.conductai.ai --api-key

Sync Guard — installs hook + MCP, pulls policies

conduct guard sync

That's it. Policy enforcement is active from the next tool call.

Guard commands

Advisory mode

When advisory mode is enabled by your security admin, all policy violations are logged as "audited" instead of blocked — the developer sees a note but the tool call proceeds. The hook still posts every event to the audit log.

To check if advisory mode is active:

conduct guard sync   # shows "· advisory" badge if active

conduct guard status

conduct verify

# Map last 24h of guard events to OWASP Agentic Top 10

conduct verify

Use a saved evidence file

conduct verify --evidence ./conduct-evidence.json

CI mode — exit 1 if any blocked events

conduct verify --strict

JSON output for downstream tooling

conduct verify --format json

OWASP mapping: no-rm-rf → A04 Excessive Agency, no-sudo → A09 Privilege Escalation, policy_signature_invalid → A07 Insufficient Monitoring, etc. All 10 categories covered.

How the PreToolUse hook works

When you run conduct guard sync, the CLI writes a Python script to ~/.conductguard/hook.py and registers it as a PreToolUse hook in ~/.claude/settings.json:

{

"hooks": { "PreToolUse": [ { "matcher": ".*", "hooks": [{ "type": "command", "command": "python3 ~/.conductguard/hook.py" }] } ] } }

Before every tool call, Claude Code runs the hook. The hook:

1. Reads tool_name and tool_input from stdin (JSON)
2. Loads ~/.conductguard/policy.json (the team ruleset)
3. Matches the call against each rule (match_tool, match_pattern, match_path_pattern)
4. Takes the rule's action:

• block — prints the policy message, exits with code 2 (Claude Code aborts the tool call)
• warn — prints the message, exits 0 (tool call proceeds, developer is notified)
• audit — posts an event silently, exits 0

1. Posts an audit event to POST /guard/events asynchronously (fire-and-forget, never slows the tool call)

How conductguard-mcp works

conduct guard sync also registers an MCP server entry in ~/.claude/settings.json:

{

"mcpServers": { "conductguard": { "command": "conductguard-mcp", "args": ["--team", " ", "--token", " "] } } }

Claude Code starts conductguard-mcp as a subprocess on launch and keeps it running. It communicates via JSON-RPC 2.0 over stdin/stdout (MCP stdio transport).

The MCP server exposes three tools that Claude can call proactively:

`guard_check` example — Claude can self-check before a sensitive action:

guard_check(tool_name="bash", tool_input={"command": "rm -rf /tmp/build"})

→ ALLOWED — no policy rule matches 'bash'.

guard_check(tool_name="bash", tool_input={"command": "curl http://internal-api/secrets"}) → BLOCKED — External network calls to internal endpoints are not permitted. [rule: no-internal-curl]

`guard_sync` example — after your security team pushes new rules:

guard_sync()

→ Policy synced — 12 rule(s) active (version: 2026-05-31T14:22:00Z).

Policy file format

Policy is stored at ~/.conductguard/policy.json and synced from the server:

{

"team_id": "uuid", "version": "2026-05-31T14:22:00Z", "rules": [ { "rule_id": "no-rm-rf", "match_tool": "bash", "match_pattern": "rm\\s+-rf", "match_path_pattern": null, "action": "block", "message": "Recursive deletes are not permitted. Use trash or targeted rm." }, { "rule_id": "audit-prod-writes", "match_tool": "edit,write", "match_path_pattern": "/prod/", "match_pattern": null, "action": "warn", "message": "Writing to prod directory — make sure this is intentional." } ] }

Keeping policy up to date

Run conduct guard sync after your security team updates rules in the ConductGuard dashboard. The sync command pulls the latest policy, rewrites the hook, and re-registers the MCP entry in any newly detected AI tool configs.

# Add to a daily cron or run manually after policy changes

conduct guard sync

---

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{

"mcpServers": { "conduct": { "command": "conduct-mcp", "args": [] }, "conductguard": { "command": "conductguard-mcp", "args": ["--team", " ", "--token", " "] } } }

Run conduct login first — conduct-mcp reads credentials from ~/.conduct/config.json. Get your agent token from Settings → Agents → Issue token in the Conduct AI dashboard.

---

VS Code + GitHub Copilot

Install from the MCP registry directly in VS Code:

code --add-mcp '{"name":"conduct","command":"conduct-mcp","args":[]}'

code --add-mcp '{"name":"conductguard","command":"conductguard-mcp","args":["--team"," ","--token"," "]}'

Or add to .vscode/mcp.json in your repo:

{

"servers": { "conduct": { "type": "stdio", "command": "conduct-mcp", "args": [] }, "conductguard": { "type": "stdio", "command": "conductguard-mcp", "args": ["--team", " ", "--token", " "] } } }

Once wired, GitHub Copilot can list your agents, trigger workflows, and check Guard policies — the same tools available in Claude Code and Cursor.

Prerequisites: pip install conduct-cli + conduct login

---

Links

• Dashboard: conductai.ai
• Docs: conductai.ai/docs
• Issues: github.com/sseshachala/conductai/issues