Ocul-PM Wiki

Last updated 2026-08-21

The manual for the places people get stuck. Short, and updated often. (As of v2.14)

Start here

• Getting Started — install, add a project, and see your first journal entry
• FAQ — who writes the entries, does it cost money, should I commit .oculpm/, what is a workday
• Screen Tour — what every screen in the sidebar is for, on one page

Concepts — what accumulates

• Today — the screen you land on. Activity rings, commit graph, standup copy
• Work Journal — how entries pile up, change diffs, sessions, the honesty audit
• Planner — a plan document agents keep current. Glyphs and the change log
• Retro — period signals, the deferred-shortcut ledger, standup and PR descriptions

Agent integration

• Claude Code — in-app vs terminal, installing the plugin, why /plugin and /mcp don't work in-app
• Other Agents — Cursor, Gemini CLI, Copilot, Windsurf, Cline, Zed, aider, Antigravity — plus the Skills & Rules hub
• Agent Panel — ask several LLMs with the same context, token badge, planner action proposals

Running it

• Windows, Tabs, Terminal, Code — several projects at once, the terminal dock and splits, in-app editing
• Settings — themes and presets, text size, API keys and fallbacks, indexing and RAG

Everything else

• Troubleshooting — common friction and how to clear it
• Data & File Layout — the .oculpm/ folder, backup and moving, what local-first actually means
• Shortcuts — navigation, tabs and windows, terminal keys, Claude Code screen keys