Summary

callx is a Node.js CLI tool designed as an "AI summoner," enabling users to manage and interact with various AI models (like Codex, Claude, OpenCode) through a unified interface. It targets developers and power users who need to integrate and orchestrate different AI services for tasks such as code generation and assistance, offering a flexible configuration system and an interactive TUI for setup.

How It Works

callx operates as a global Node.js CLI, with its core functionality centered around a structured configuration directory (~/.config/callx/). It allows users to define and manage AI model providers in providers.json, configure AI agents ("sprites") with specific models, skills, and MCP servers in the sprites/ directory, and set up custom MCP servers. A TUI configuration tool, callcli, simplifies the management of these components, offering interactive editing for providers, sprites, and Git worktree creation.

Quick Start & Requirements

• Primary install: npm install -g @greenhill/callx
• Prerequisites: Node.js 18+
• Optional (for specific providers): npm install -g opencode-ai, npm install -g @anthropic-ai/claude-code
• Configuration: First run of any call command auto-initializes ~/.config/callx/. Manual editing of ~/.config/callx/providers.json is required to add API keys and endpoints.
• Docs/Demo: Interactive TUI (callcli) serves as a primary interface.

Highlighted Details

• TUI Configuration (callcli): Provides an interactive, Monokai-styled TUI for managing AI providers, defining AI agents ("sprites"), and creating Git worktrees.
• Sprite System: Enables the creation of distinct AI agents by linking providers, skills, and MCP servers, allowing for customized AI workflows.
• MCP Server Management: Unified handling of Multi-Channel Protocol servers, with support for local and remote configurations, automatically translating them for compatible CLIs.
• Git Worktree Integration: Streamlined creation of Git worktrees directly from the callcli TUI, with an option to immediately enter a sub-shell in the new directory.

Maintenance & Community

No specific details on contributors, sponsorships, or community channels (like Discord/Slack) were found in the provided README.

Licensing & Compatibility

• License: GPL-3.0.
• Compatibility: As a GPL-3.0 licensed project, its use in closed-source commercial applications may be restricted due to the copyleft nature of the license.

Limitations & Caveats

The GPL-3.0 license imposes copyleft obligations that could be a significant consideration for commercial adoption or integration into proprietary software. The worktree creation feature, while convenient, launches a sub-shell rather than directly changing the parent shell's directory.