PM OS CLI

Interactive command-line tool for PM OS diagnostic sessions.

Installation

Prerequisites

• Node.js 16 or higher
• Anthropic API key (get one here)

Install Globally

# From this directory
npm install -g .

# Or from npm (when published)
npm install -g pmos-cli

Install Locally (Development)

cd cli
npm install
npm link

Setup

1. Configure API Key

pmo config --api-key sk-ant-your-key-here

2. Verify Configuration

pmo config --show

Usage

Start Diagnostic Session

# Navigate to your pmos directory (or any subdirectory)
cd /path/to/pmos

# Start session
pmo

# Or explicitly
pmo start

Example Session

╔════════════════════════════════════════╗
║           PM OS Diagnostic             ║
║    AI-Assisted Management Reasoning    ║
╚════════════════════════════════════════╝

📁 Loading PM OS from: /Users/you/pmos
✓ Loaded 24 knowledge files
Using model: sonnet (claude-sonnet-4-5-20250929)
Type your management situation below. Type "exit" to quit.

You: My senior engineer has been quiet in meetings for 3 weeks...

PM OS: [diagnostic response]

You: exit
👋 Session ended. Good luck with your management challenges!

Configuration Options

# Set model (sonnet, opus, or haiku)
pmo config --model haiku

# Show current settings
pmo config --show

# Version info
pmo version

Cost Tracking

The CLI shows approximate cost per interaction:

[Tokens: 15234 in, 1456 out | Cost: ~$0.067]

Typical costs:

• Simple diagnosis: $0.04-0.08
• Complex multi-turn: $0.10-0.15
• Monthly (20 sessions): $1-3

How It Works

1. Auto-loads PM OS - Finds pmos/os/ and .pmos-config/system-prompt.md automatically
2. Streams context - Sends system prompt + knowledge base to Claude
3. Interactive chat - Multi-turn conversation with context retention
4. Cost tracking - Shows token usage and estimated cost

Directory Structure

pmos/
├── pmos/
│   └── os/                    # Knowledge base (auto-loaded)
├── .pmos-config/
│   └── system-prompt.md       # System instructions (auto-loaded)
└── cli/
    ├── bin/pmo.js            # CLI entry point
    ├── src/
    │   ├── config.js         # API key management
    │   ├── loader.js         # Knowledge base loader
    │   └── session.js        # Interactive session
    └── package.json

Troubleshooting

"PM OS knowledge base not found"

• Make sure you're in the pmos directory or a subdirectory
• Verify pmos/os/ and .pmos-config/system-prompt.md exist

"No API key configured"

pmo config --api-key sk-ant-your-key

"Invalid API key format"

• API key should start with sk-ant-
• Get your key from https://platform.claude.com

API Errors (401, 429, etc.)

• 401: Invalid or expired API key
• 429: Rate limit (wait a moment)
• 500: Anthropic service issue (try again)

Development

Development Guidelines

Before modifying code:

1. Read CODING_CONSTITUTION.md - Core principles and anti-patterns
2. Use PRE_COMMIT_CHECKLIST.md - Tactical checks before committing

These files codify lessons learned and prevent common mistakes (outdated APIs, missing error handling, etc.).

Run Without Installing

cd cli
npm install
node bin/pmo.js

Test Configuration

node bin/pmo.js config --show

Publish to npm

Before publishing, complete PRE_COMMIT_CHECKLIST.md

npm pack  # Inspect tarball first
npx publint  # Catch publishing issues
npm login
npm publish

Model Options

| Model | Speed | Cost | Best For | |-------|-------|------|----------| | sonnet | Medium | $0.06/diagnosis | Default - balanced | | opus | Slow | $0.20/diagnosis | Complex cases | | haiku | Fast | $0.01/diagnosis | Quick pattern checks |

License

MIT

Version

CLI: 0.1.0 Knowledge Base: 0.1.0 System Prompt: 0.1.0