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 --allowed-tools Read Grep Glob    # Pre-approve tools (space or comma; CC --allowed-tools)
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-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

Metadata

Release files for langchain-agentx-cli 0.8.4

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.4
File	Size	Uploaded
langchain_agentx_cli-0.8.4.tar.gz	399.7 kB	Sep 19, 2026	Details

Built distribution (wheel)

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

Total release size: 969.7 kB

Release files / langchain_agentx_cli-0.8.4.tar.gz

Download URL	langchain_agentx_cli-0.8.4.tar.gz
Size	399.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`c6f76857285215f510461b861f7112a1789236105fc76b9cf62187e1d54fc639`
BLAKE2b-256 checksum How to use checksums	`34c8cb9c6ff461bc7ca1961c5e0e82fcb469ce6b55a89005543e7f6e2fa3c41e`
Upload date	Sep 19, 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.4-py3-none-any.whl

Download URL	langchain_agentx_cli-0.8.4-py3-none-any.whl
Size	570.0 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`9f82a8b1edbda97cccef76bae2f7b0ef97f00c3c7ad878171a603bb77b8e1d22`
BLAKE2b-256 checksum How to use checksums	`5f226fc210f8366bd54ad47f12d047eaa31c8cb1f6292a02dab67d658f66c58d`
Upload date	Sep 19, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.11.6`