Back to Home
· product · apcore-cli
apcore-cli logo

apcore-cli

High-performance CLI adapter for apcore modules

apcore-cli maps registered apcore modules — including modules scanned from a complete OpenAPI 3.0 or 3.1 document via apcore-toolkit — to terminal subcommands. It derives arguments from module schemas, supports STDIN and TTY-aware output, and routes calls through the same validation, ACL, approval, and audit path used by direct execution. It is the terminal adapter alongside apcore-mcp and apcore-a2a.

· 01

Features

01Convention-Based Routing: Map module IDs to CLI commands
02OpenAPI Import: Scan a complete OpenAPI 3.0 or 3.1 document through apcore-toolkit and route each operation as a CLI subcommand
03Schema-Driven Args: Uses input_schema to generate CLI arguments, types, and validation
04Boolean Flag Pairs: --verbose / --no-verbose from boolean schema properties
05Enum Choices: Click validation for enum properties
06STDIN Piping: --input - reads JSON from STDIN, CLI flags override
07TTY-Adaptive Output: Rich tables for terminals, JSON for pipes
08Approval Gate: TTY-aware HITL prompts for sensitive operations
09Security: API key auth, append-only audit logging, subprocess sandboxing
10Shell Completions: Generate completion scripts for bash/zsh/fish
11Man Pages: Generate roff-formatted man pages
· 02

Get Started

TypeScript · Implementation

TypeScript/JavaScript implementation of the apcore-cli adapter.

Install
$ npm install -g apcore-cli
Quick Start
typescript.ts
# Install globally
npm install -g apcore-cli

# Point to your extensions directory
export APCORE_EXTENSIONS_ROOT=./dist/extensions

# Run a module
apcore-cli math.add --a 5 --b 10
· related

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

A2A adapter for projecting apcore modules to Agent Card and task interfaces.

View Product
apcore-toolkit logo

apcore-toolkit

Shared utilities and scanner base for building custom apcore adapters.

View Product