Claude Agent Spawner 🚀

A powerful CLI tool and Node.js library to spawn autonomous AI agents using Claude Code or Z.AI (GLM-4.6).

Designed to be robust, cross-platform (Windows/macOS/Linux), and developer-friendly.

✨ Features

• Autonomous Agents: Spawns agents in separate terminal windows that work independently.
• Multi-Provider Support:
  • Anthropic: Uses the standard Claude Code CLI.
  • Z.AI: Seamlessly integrates with Z.AI's GLM-4.6 model (via Anthropic API compatibility).
• Robust Prompting: Uses a file-based prompting strategy to handle complex, multi-line instructions without shell escaping issues.
• Zero-Dependency Runtime: The core logic uses native Node.js modules (except for the bundled claude-code).
• Cross-Platform: Works on Windows (cmd/PowerShell), macOS (Terminal.app), and Linux (GNOME Terminal).

📦 Installation

Install globally via npm:

npm install -g claude-agent-spawner

Or run directly with npx:

npx claude-agent-spawner --prompt "Your task..."

🛠️ Usage

Basic Command

agent --prompt "Create a simple HTML website"

Advanced Usage

Specify a role and use the Z.AI provider:

agent --prompt "Write a Python script for data analysis" \
      --role "Data Scientist" \
      --provider zai \
      --api-key "YOUR_ZAI_API_KEY"

CLI Options

| Option | Alias | Description | Default | | :--- | :--- | :--- | :--- | | --prompt | -p | Required. The task instructions for the agent. | - | | --role | -r | The persona/role of the agent. | CLI Agent | | --provider | - | AI Provider: anthropic or zai. | anthropic | | --api-key | - | API Key for Z.AI (required if provider is zai). | - | | --verbose | - | Enable detailed logging for debugging. | false | | --help | -h | Show the help message. | - |

📚 Library Usage (Node.js)

You can also use this package programmatically in your own Node.js tools:

const spawnAgent = require('claude-agent-spawner');

// Spawn a standard Claude agent
spawnAgent('Refactor this code', {
    agentType: 'Senior Dev',
    verbose: true
});

// Spawn a Z.AI agent
spawnAgent('Generate unit tests', {
    agentType: 'QA Engineer',
    provider: 'zai',
    apiKey: process.env.ZAI_API_KEY
});

💡 Tips

• Windows Users: The tool automatically handles path escaping and window management (cmd /k), so you don't need to worry about the terminal closing immediately on errors.
• Z.AI Integration: The tool automatically maps the Anthropic models (sonnet, opus) to Z.AI's glm-4.6 and glm-4.5-air as per their documentation.

📄 License

ISC