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.6

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.6
File	Size	Uploaded
langchain_agentx_cli-0.8.6.tar.gz	400.8 kB	Sep 20, 2026	Details

Built distribution (wheel)

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

Total release size: 971.8 kB

Release files / langchain_agentx_cli-0.8.6.tar.gz

Download URL	langchain_agentx_cli-0.8.6.tar.gz
Size	400.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`fb62c5ea37fe37fb30135c9e080c68ad4fbc783099e0c1616ea922ace715d9fd`
BLAKE2b-256 checksum How to use checksums	`70802b0bf83add54e1fdc4b4bd35cf65681f7bf5d149c65d335a8881200289fd`
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.6-py3-none-any.whl

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