@workersdao/workers-acli

Claude CLI Wrapper

A command-line interface for interacting with Claude AI.

Installation

npm install -g @workersdao/workers-acli

Commands

ask

Ask Claude a single question.

ccli ask "What is the capital of France?"

Options:

• -m, --model <model> - Specify the Claude model to use
• -f, --file <path> - Include a file with the request
• -t, --max-tokens <number> - Maximum tokens in the response
• --temperature <number> - Temperature for response generation
• --json - Request JSON output

chat

Start an interactive chat session with Claude.

ccli chat

analyze

Analyze a file or directory with Claude.

ccli analyze path/to/file.js

setup

Install and configure required dependencies for optimal usage:

• GitHub CLI (gh) - Checks if installed and installs if needed
• claude-code global package - Checks if installed and installs if needed
• GitHub authentication - Prompts for GitHub auth token and authenticates with GitHub CLI
• Anthropic API key - Prompts for API key and sets it as a global environment variable

This command provides a complete setup experience:

ccli setup

During setup, you will be prompted to enter:

1. Your GitHub auth token - Used to authenticate with GitHub CLI
2. Your Anthropic API key - Set as a global environment variable and added to .env file

The setup command will:

• Add the Anthropic API key to your shell configuration file (.zshrc, .bashrc, or .profile)
• Create or update the .env file in the current directory with your Anthropic API key

config

Manage CLI configuration settings:

# Set a configuration value
ccli config set working-dir /opt/worker/session-123

# Get a configuration value
ccli config get working-dir

# List all configuration values
ccli config list

# Remove a configuration value
ccli config unset working-dir

The config command will:

• Update the environment variable in your shell configuration file (.zshrc, .bashrc, or .profile)
• Update the local .env file if it exists
• Store the configuration in a global config file (~/.claude-cli/config.json)
• Make the setting available to all commands
• Ensure the setting persists between CLI invocations

Environment Variables

Create a .env file in your project root with the following variables:

ANTHROPIC_API_KEY=your_api_key_here
CLAUDE_WORKING_DIR=/opt/worker/session-123  # Optional: Working directory for isolation

Available Environment Variables

• CLAUDE_PATH - Path to the Claude CLI executable (default: 'claude')
• CLAUDE_DEFAULT_MODEL - Default model to use (default: 'claude-3-haiku-20240307')
• CLAUDE_MAX_TOKENS - Default maximum tokens for responses (default: 4000)
• CLAUDE_WORKING_DIR - Working directory for Claude commands (for isolation purposes)

License

MIT