PM OS CLI

Interactive command-line tool for PM OS diagnostic sessions.

Installation

$3

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

$3

``bash


From this directory

npm install -g .

Or from npm (when published)

npm install -g pmos-cli
`

$3

`bash
cd cli
npm install
npm link
`

Setup

$3

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

$3

`bash
pmo config --show
`

Usage

$3

`bash


Navigate to your pmos directory (or any subdirectory)

cd /path/to/pmos

Start session

pmo

Or explicitly

pmo start
`

$3

`
╔════════════════════════════════════════╗
║ 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!
`

$3

`bash


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

$3


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

$3

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

$3

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

$3

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

Development

$3

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.).

$3

`bash
cd cli
npm install
node bin/pmo.js
`

$3

`bash
node bin/pmo.js config --show
`

$3

Before publishing, complete PRE_COMMIT_CHECKLIST.md

`bash
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