Skip to main content
The Apie CLI handles onboarding, diagnostics, capability management, guardrail templates, reports, and MCP proxy.
LanguageInstallInvoke
TypeScriptnpm install -D @apie/clinpx apie
Pythonpip install apie-sdkapie

init

Initialize Apie in your project. Creates config file and .env.example.
npx apie init   # TypeScript
apie init       # Python

send-test-event

Send a smoke test event and print session replay URL.
npx apie send-test-event [--mode pipeline|single|proof]
apie send-test-event [--mode pipeline|single|proof]
FlagDefaultDescription
--modepipelinepipeline (full session), single (one tool call), or proof (activation proof)

doctor

Run connectivity and queue diagnostics.
npx apie doctor [--send-test] [--mcp] [--mcp-config apie.mcp.json]
apie doctor [--send-test] [--mcp] [--mcp-config apie.mcp.json]
FlagDescription
--send-testSend a test event after checks
--mcpValidate MCP proxy config
--mcp-configPath to MCP config (default: apie.mcp.json)

capabilities declare

Declare capabilities from your config file.
npx apie capabilities declare
apie capabilities declare

guardrails enable

Enable a guardrail template by key.
npx apie guardrails enable <key> [--mode monitor|enforce]
apie guardrails enable <key> [--mode monitor|enforce]

report create

Generate a boundary report.
npx apie report create [--last 24h|7d|30d] [--environment <env>] [--title <title>]
apie report create [--last 24h|7d|30d] [--environment <env>] [--title <title>]
FlagDefaultDescription
--last7dTime window
--environmentFilter by environment
--titleReport title

mcp proxy

Run the Apie MCP proxy in front of an upstream MCP server.
npx apie mcp proxy [options]
apie mcp proxy [options]
FlagDefaultDescription
--configapie.mcp.jsonMCP config file path
--serverServer name (multi-server config)
--transportstdiostdio or sse
--port3100SSE listen port
--modefrom configmonitor or enforce
--approval-timeoutfrom confige.g. 10m
--upstream-commandfrom configUpstream MCP command
--upstream-argfrom configUpstream MCP arg (repeatable)
--run-idApie run ID for emitted events
Python requires pip install "apie-sdk[mcp-proxy]" for the proxy command.

Environment variables

APIE_API_KEY=apie_sk_test_...
APIE_BASE_URL=https://api.apie.sh