Back to Home
apcore-cli logo

apcore-cli

High-performance CLI adapter for apcore modules

About

apcore-cli is the "inside-out" adapter for the apcore ecosystem. apcore-cli takes your apcore modules and automatically exposes them as CLI subcommands — with zero code changes. It handles zero-config routing, schema-driven arguments, boolean flag pairs, enum choices, STDIN piping, TTY-adaptive output, approval gates, schema validation, security features, shell completions, man pages, and audit logging. It serves as the terminal-native counterpart to apcore-mcp and apcore-a2a.

Features

Zero-Config Routing: Automatically maps module IDs to CLI commands
Schema-Driven Args: Uses input_schema to generate CLI arguments, types, and validation
Boolean Flag Pairs: --verbose / --no-verbose from boolean schema properties
Enum Choices: Click validation for enum properties
STDIN Piping: --input - reads JSON from STDIN, CLI flags override
TTY-Adaptive Output: Rich tables for terminals, JSON for pipes
Approval Gate: TTY-aware HITL prompts for sensitive operations
Security: API key auth, append-only audit logging, subprocess sandboxing
Shell Completions: Generate completion scripts for bash/zsh/fish
Man Pages: Generate roff-formatted man pages

Get Started

Python Implementation

Python reference implementation of the apcore-cli adapter.

Install
pip install apcore-cli
Quick Start
# Clone the Python SDK (includes example modules)
git clone https://github.com/aipartnerup/apcore-cli-python.git
cd apcore-cli-python
pip install -e ".[dev]"

# Point to the example extensions
export APCORE_EXTENSIONS_ROOT=examples/extensions

# Run your first module
apcore-cli math.add --a 5 --b 10

Related Products

apcore logo

apcore

The schema-driven module development framework that apcore-cli exposes to the terminal.

View Product
apcore-mcp logo

apcore-mcp

Automatic MCP Server & OpenAI Tools bridge for any apcore-based project.

View Product
apcore-a2a logo

apcore-a2a

Secure Agent-to-Agent communication bridge for autonomous collaboration.

View Product