langchain-agentx-cli 0.7.0

Terminal CLI/TUI for AgentX: migrate Claude Code Ink UI, backed by langchain-agentx-python SDK.

langchain-agentx-cli

AgentX Code — Terminal AI coding assistant with Claude Code compatible TUI.

依托 langchain-agentx-python SDK，提供功能完整的终端编码助手。

Installation

pip install langchain-agentx-cli

Requires Python 3.11+ and ANTHROPIC_API_KEY environment variable.

Quick Start

# Navigate to your project directory
cd ~/my-project

# Start AgentX Code
agentx-code

Environment Setup

# Set your Anthropic API key
export ANTHROPIC_API_KEY="sk-ant-..."

Command Options

agentx-code                                    # Start in current directory
agentx-code --workspace-root /path/to/project  # Specify workspace
agentx-code --model claude-sonnet-4-20250514  # Specify model
agentx-code --provider claude | openai        # Choose provider
agentx-code --dangerously-skip-permissions    # Skip permission prompts (CC-aligned)
agentx-code --show-config                     # Print merged config

Input Habits (Claude Code Compatible)

Key	Action
Enter	Send message
Shift+Enter	Insert newline
\ + Enter	Insert newline (alternative)
↑ / ↓	Navigate history / move in multiline
Tab	Command completion
Ctrl+R	History search
Ctrl+Shift+L	Clear messages
Ctrl+C	Cancel generation / Quit (twice)

Type /help in the REPL for full command list.

Development

# Clone and install in editable mode
git clone https://github.com/GoodMood2008/langchain-agentx-cli.git
cd langchain-agentx-cli
pip install -e ".[dev]"

# Run tests
pytest tests -v

# Run directly (without install)
python -m langchain_agentx_cli

Configuration

Config file location: ~/.config/langchain_agentx/langchain_agentx.json

{
  "llm": {
    "provider": "claude",
    "model": "claude-sonnet-4-20250514",
    "api_key": null,
    "base_url": null
  },
  "theme": "dark",
  "show_suppressed_text": false
}

历史字段 user_message_preview_lines 已随 BriefTool/user_message 移除而废弃，请勿写入新配置。

Architecture

工程约定与开发说明见根目录 CLAUDE.md。

Layer	Name	Description
PyPI Package	langchain-agentx-cli	pip install langchain-agentx-cli
CLI Command	agentx-code	User types in terminal
Python Package	langchain_agentx_cli	import for use as library

Design Docs

• Tool naming SSOT — RuntimeTool.name、GrantScope、MemoryToolKind 边界
• Implementation Plans

历史：D01 user_message（BriefTool 已移除，仅作归档）

License

Apache License 2.0