cf-claude

For use with Clarity Forge — This package connects your local Claude Code instance to Clarity Forge as an AI agent employee.

The Clarity Forge Agent Connector for Claude Code.

Transform Claude Code into an AI agent employee that integrates seamlessly with Clarity Forge — automatically receiving project knowledge, team standards, and goals at the start of each session, then capturing learnings back into your workspace.

No more copy-pasting context. No more lost knowledge. Every session builds on what came before.

What It Does

cf-claude connects your local Claude Code instance to Clarity Forge as an AI agent employee:

• Pull Context - Automatically retrieves project knowledge (architecture, coding standards, brand guides) when tasks begin
• Do the Work - Claude Code executes with full awareness of your team's standards and goals
• Capture Learnings - Extracts decisions, patterns, and lessons learned after each session
• Share with Team - Makes discoveries available to future team members and agents

The result: compounding intelligence where each session makes the next one smarter.

Learn more about Clarity Forge agents →

Installation

Option 1: Global Install (Recommended)

Install permanently for repeated use:

npm install -g @clarityforge/cf-claude

Then run anytime:

cf-claude

Option 2: Run with npx

Try it instantly without installing:

npx @clarityforge/cf-claude

This downloads and runs the latest version each time - perfect for trying it out or ensuring you always have the newest release.

Usage

Supervised Mode (Default)

Work in normal Claude Code sessions with automatic context injection:

cf-claude

This is the default mode. It:

• Runs standard Claude Code sessions you're already familiar with
• Automatically injects project knowledge, goals, and standards at session start
• Captures learnings and decisions back to Clarity Forge when done
• Best for: Collaborative work where you want to guide Claude

Autonomous Mode

Let the agent work independently in headless environments:

cf-claude --autonomous

This mode:

• Receives task assignments from Clarity Forge
• Works autonomously with full project context
• Reports results back automatically
• Best for: Fire-and-forget tasks, CI/CD pipelines, background processing

Both modes will guide you through OAuth authentication on first run and connect your local Claude Code instance as an AI agent employee.

Requirements

• Node.js >= 20.0.0
• Claude Code installed and configured
• Clarity Forge account with agent access

Features

• OAuth authentication with Clarity Forge
• Supervised agent execution
• Task assignment and tracking
• Automatic progress reporting
• Integration with Clarity Forge MCP server
• Multi-agent support with role-based specialization

Multi-Agent Workflows

cf-claude supports multiple specialized agents in the same codebase, each with different roles and expertise:

Managing Multiple Agents

Each directory can have multiple agents cached locally. Agents are sorted by most recent use, with the default agent shown first.

List and switch agents:

cf-claude
# Shows picker with all cached agents
# Press Enter to select default (most recently used)
# Or type a number to select a different agent

Add a new specialized agent:

cf-claude --add-agent
# Walks through agent registration
# Adds to cache alongside existing agents

Remove an agent from cache:

cf-claude --clear-agent <agent-id>
# Removes specific agent

Reset all agents:

cf-claude --init
# Clears all cached agents
# Runs full selection flow

Refresh project scopes:

cf-claude --scope
# Updates which projects the current agent has access to

Example: Feature Development + Security Review

# Set up a feature development agent
cf-claude --add-agent
# Select "Engineering" role → "Gideon" template
# Choose projects: "Backend API", "Frontend"

# Later, add a security specialist
cf-claude --add-agent  
# Select "Security" role → "Nyx" template
# Choose projects: "Backend API"

# Switch between them as needed
cf-claude
# Shows both agents, press Enter for most recent
# Or select the other agent by number

Agent Specialties

When registering an agent, you choose a role that determines their domain expertise:

• Engineering - Code architecture, technical decisions
• Marketing - Market insights, positioning
• Legal - Compliance, legal precedents
• Production - Content creation, production workflows
• Product - Product strategy, user research
• Sales - Sales insights, customer engagement

Each domain comes with pre-configured agent templates with different personalities and capabilities.

How It Works

• Agents are cached per directory in .cf-claude/agent-{id}.json
• Each agent maintains independent project scopes and domain
• Most recently used agent becomes the default selection
• Authentication tokens are shared across all agents in the directory

CLI Reference

Flags

• --autonomous - Run in autonomous mode (headless, non-interactive)
• --dangerous - Enable dangerous mode (bypass all permissions)
• --working-dir <path> - Override working directory
• --poll-interval <seconds> - Override polling interval
• --agent-id <id> - Use specific agent ID (fetches from server)
• --init - Re-run agent selection (clears all cached agents)
• --add-agent - Add a new agent to this directory
• --clear-agent <agent-id> - Remove specific agent from cache
• --scope - Refresh project scopes for current agent
• --logout - Clear credentials and exit
• --debug - Enable debug logging
• --resume - Resume the last task from where it left off

License

Proprietary / All Rights Reserved

Copyright (c) 2026 Clarity Forge