Official Command Line Interface for Managing and Debugging the Paper AI Ecosystem.
paper-cli is the TypeScript developer CLI (@artificialpaper/cli). It provides command-line utilities for starting local development services, monitoring system health, testing gRPC endpoints, streaming logs, and inspecting active call sessions.
Install globally using npm or pnpm:
npm install -g @artificialpaper/cliOr run via npx:
npx @artificialpaper/cli --helpStarts all ecosystem microservices locally via Docker Compose or process manager.
paper start --env developmentChecks system health and displays status for paper-core, paper-caller, paper-memory, Redis, and ChromaDB.
paper statusExecutes end-to-end synthetic voice tests or gRPC ping benchmarks.
# Test paper-core gRPC endpoint
paper test core --host localhost:50051
# Test WebSocket audio stream echo
paper test voice --url ws://localhost:8000/ws/audioTail aggregated JSON logs across services with formatting and level filters.
paper logs --service paper-caller --level errorpaper-cli/
├── src/
│ ├── index.ts # CLI entry point (Commander.js)
│ ├── commands/ # Subcommand handlers (start, status, test, logs)
│ ├── client/ # gRPC & REST client helpers
│ └── utils/ # Terminal formatting & table renderers
├── tests/ # Jest test suite
├── package.json # Node package configuration
├── tsconfig.json # TypeScript compiler config
└── README.md
# Clone repository
git clone https://github.com/artificialpaper/paper-cli.git
cd paper-cli
# Install dependencies
npm install
# Build TypeScript source
npm run build
# Link CLI globally for local testing
npm link- paper-core - Central LLM Inference Gateway
- paper-caller - Real-Time Voice AI Agent Runtime
- paper-infra - Docker & Operations Configs
- paper-docs - Official Ecosystem Documentation Portal
This project is licensed under the MIT License - see the LICENSE file for details.