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-6         # Specify model
agentx-code --provider claude | openai        # Choose provider
agentx-code --dangerously-skip-permissions    # Skip permission prompts (CC-aligned)
agentx-code --allowed-tools Read Grep Glob    # Pre-approve tools (space or comma; CC --allowed-tools)
agentx-code --allowed-tools Bash,Skill        # Tier1 scan profile (OPS/new_agent); see SDK A25 R0
agentx-code --disallowed-tools Bash Edit      # Block tools (space or comma; deny wins)
agentx-code --tools Read Grep Glob            # Only these built-ins; others auto-denied (CC --tools)
agentx-code -p "summarize README.md"          # One-shot print mode (headless)
agentx-code --show-config                     # Print merged config

Read-only audit (aligned with Claude Code CLI semantics):

agentx-code --permission-mode dontAsk \
  --allowed-tools Read,Grep,Glob \
  --disallowed-tools Bash,Edit,WebSearch,WebFetch

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-6",
    "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

Metadata

Release files for langchain-agentx-cli 0.8.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for langchain-agentx-cli 0.8.5
File	Size	Uploaded
langchain_agentx_cli-0.8.5.tar.gz	400.2 kB	Sep 20, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for langchain-agentx-cli 0.8.5
File	Interpreter	ABI	Platform	Reset
langchain_agentx_cli-0.8.5-py3-none-any.whl 570.6 kB Sep 20, 2026	Python 3	none	any	Details

Total release size: 970.8 kB

Release files / langchain_agentx_cli-0.8.5.tar.gz

Download URL	langchain_agentx_cli-0.8.5.tar.gz
Size	400.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`67220d26d2a4cfaedbabf01a3aded102cc0c465a0eaf695e6c319f1f5293ad2b`
BLAKE2b-256 checksum How to use checksums	`051479fbe2e143dacca6ba9ada23fac303d8b78efbced2affaf6d0f9b61fa310`
Upload date	Sep 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.11.6`

Release files / langchain_agentx_cli-0.8.5-py3-none-any.whl

Download URL	langchain_agentx_cli-0.8.5-py3-none-any.whl
Size	570.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`4f23694a461a635af3ca0d7240826a7d89820754a3e0e9d96252cc2ddb077b38`
BLAKE2b-256 checksum How to use checksums	`5df1e77df62af94edcc661aa262e7aac10c46ca654fcf027a28f869a79d018c8`
Upload date	Sep 20, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.11.6`