Quickstart

This guide gets you to the first useful OME moment: initialize the library, then send a real task to your agent and see whether OME recall appears automatically.

1. Initialize

npx oh-my-experience@latest init

This runs the latest published OME CLI through npm, creates your local experience library, and lets you choose which supported agents to connect. For each selected agent, OME installs the prompt-time hook and bundled skill. Codex is the best-tested path today; Claude uses the same hook runtime. It is safe to rerun.

To install the command globally instead:

npm install -g oh-my-experience
ome init

2. Send a real task to your agent

Copy this to your agent:

Create a goal and start now: in /tmp/ome-todo-demo, build a small single-page Todo app with plain HTML, CSS, and JavaScript.
It should let me add tasks, mark tasks complete, delete tasks, clear completed tasks, show the remaining count, persist tasks in localStorage, and look usable on a narrow mobile viewport.
Verify it through the real browser entry before reporting completion.
After finishing, guide me through the OME lifecycle: scan this full run, summarize reusable lessons, review the generated drafts with me, and only add approved drafts to the experience library.

The installed hook handles recall at prompt time. You should not need to run a manual search command just to prove setup works. The built-in starter cards make the first automatic recall possible before you have written your own cards.

3. Check health when needed

Use health checks when setup looks wrong or before a release:

npx oh-my-experience@latest doctor
npx oh-my-experience@latest hook status --provider codex
npx oh-my-experience@latest hook status --provider claude

doctor checks the library, config, package identity, hooks, skills, and card schema. It is useful for troubleshooting, but the first product proof should be recall, not a green status screen.

4. Next steps

• Create your first approved card: First Experience Card
• See the end-to-end /goal example: Examples
• Use a repository-local library: Global And Project Libraries
• Configure Codex or Claude directly: Codex, Claude

Quick reference

I want to...	Command
Initialize OME	npx oh-my-experience@latest init
Check health	npx oh-my-experience@latest doctor
Inspect hooks	npx oh-my-experience@latest hook status --provider codex
Create a project library	npx oh-my-experience@latest project init
Start a retrospective	npx oh-my-experience@latest reflect start --focus "focus area"

For local development from source, use node bin/ome.js after npm install && npm run build.