Getting Started

30 Seconds: What PD Does

Your AI agent keeps making the same mistakes? PD captures those mistakes, finds the pattern, and lets you turn them into reviewed, reversible rules — so the agent doesn't repeat them.

Agent repeats a mistake → PD spots the pattern → You review → Agent improves

You're always in control. Nothing activates without your approval.

2 Minutes: Install & Go

Prerequisites: Node.js ≥ 18 | OpenClaw CLI installed

1. Install

npx create-principles-disciple --yes
openclaw gateway --force

2. Verify

pd runtime canary --workspace "<your-workspace-path>"

See healthy? You're good.

3. Open the Console

pd console open --workspace "<your-workspace-path>"

This opens the local review console in your browser. If port 3100 is busy, PD picks the next available local port.

The console is loopback-only. It binds to your own machine, not the public network.

4. Let It Run

Use your AI agent as usual. When it makes repeated mistakes, PD will:

1. Capture the pain signal automatically
2. Diagnose whether it's a one-off or a pattern
3. Propose a principle candidate

You'll see the proposal in the console. Choose one of three actions:

Action	What Happens	When to Use
Prompt	Soft reminder injected into agent context	Default choice — low risk
RuleHost	Hard rule that blocks violating actions	When soft reminders aren't enough
Defer	Skip and archive	When it's not worth acting on

5. Roll Back If Needed

Changed your mind? Undo anytime:

/pd-rollback-impl <id>

Report a Problem

Seed users should not need to collect logs manually. In the console, use Report Problem to create a local feedback draft with a privacy preview.

PD does not automatically upload prompts, chat logs, files, environment variables, or tokens. You review the draft first, then copy it into email or GitHub if you choose.

That's It

PD is now watching for repeated mistakes and waiting for your review. No configuration needed — it just works.

---

Stuck?

• AI won't edit files? → Check if a RuleHost rule is blocking the operation
• Console won't open? → pd console open --workspace "<your-workspace-path>" --json
• Check health anytime → pd runtime canary --workspace "<your-workspace-path>" --json

Want more? → User Guide | Development Guide