agent-slack-cli

Connect any project to Agent Slack for autonomous AI coding.

Quick Start

# Navigate to your project
cd /path/to/your-project

# Initialize Agent Slack
npx agent-slack-cli init

# Start the worker (foreground)
npx agent-slack-cli start

# Or install as background service (auto-starts on login)
npx agent-slack-cli install-service

Commands

init

Initialize Agent Slack in the current project.

npx agent-slack-cli init

This will:

• Ask for your Agent Slack URL
• Ask for a project ID
• Ask for your Claude API key
• Create .agent-slack/.env with configuration
• Optionally create the project in Agent Slack

start

Start the agent worker in the foreground.

npx @agent-slack/cli start

The worker will:

• Poll Agent Slack for pending tasks
• Execute tasks using Claude
• Commit changes to git
• Report progress back to Agent Slack

Press Ctrl+C to stop.

install-service

Install as a background service that auto-starts on login (macOS).

npx @agent-slack/cli install-service

uninstall-service

Remove the background service.

npx @agent-slack/cli uninstall-service

status

Check the worker status and pending tasks.

npx @agent-slack/cli status

How It Works

1. You send a task to @coder-{project-id} in Agent Slack (from mobile or web)
2. The worker polls for new tasks
3. When a task is found, Claude executes it using tools:
   • Read/write/edit files
   • Search code
   • Run commands
   • Commit to git
4. Progress and completion are reported back to Agent Slack

Configuration

Configuration is stored in .agent-slack/.env:

AGENT_SLACK_URL=https://agent-slack.vercel.app
PROJECT_ID=my-project
ANTHROPIC_API_KEY=sk-ant-...
POLL_INTERVAL_MS=10000
WORKSPACE_PATH=/path/to/project

Requirements

• Node.js 18+
• macOS (for background service), or run manually on Linux/Windows
• Claude API key (Anthropic)