oh-my-patent

Meet Archimedes. Turn your “Eureka!” into a patent disclosure.

A patent workflow toolkit for Claude Code, Codex, and OpenCode, available as a plugin or a portable Agent Skill. Archimedes orchestrates specialist agents across research, ideation, drafting, review, and diagrams—with traceable, forkable decision paths.

Quick start

Choose Plugin for Archimedes with 14 agents, 6 skills and 9 commands, or Skill for one portable entry with bundled role resources and runtime. Node.js >=22 is required. Both modes support Claude Code, Codex and OpenCode. Run installation commands in your patent workspace.

Plugin installation (default)

npm install -g oh-my-patent
oh-my-patent adapt install

The first command installs the CLI globally for project management. The second installs the plugin configurations for Claude Code, Codex and OpenCode in the current workspace. To install only one host, optionally append --tool claude-code, --tool codex or --tool opencode to the second command.

Open the workspace in your host and select Archimedes; see the usage guide for enabling its entry point.

Quick installation with npx

Run the installer without first installing the CLI globally:

npx oh-my-patent@latest adapt install

This writes the same plugin configurations to the workspace. For later CLI commands, use npx oh-my-patent@latest <command> or install the CLI globally as above.

Skill installation

Use the Skills CLI with Git and Node.js >=22.20:

npx skills@latest add https://github.com/illusionaireal/oh-my-patent/tree/master/skills/oh-my-patent --skill oh-my-patent --copy

The installer detects hosts and offers selection when needed. Choose Claude Code, Codex or OpenCode, and choose Project to copy the complete Skill and runtime into the current workspace. Open it in the selected host and select oh-my-patent. For use across projects, append --global for user-level installation. No global oh-my-patent CLI is required.

Other Skill installation methods: ZIP, project CLI and npm archive

ZIP download — manual installation

Download and extract the repository ZIP. Copy the complete skills/oh-my-patent directory inside the archive to the Skill location for your host below. The runtime is included; no source build is needed.

oh-my-patent CLI — managed installation

Use this method for the project's installation backups and rollback commands. Replace <host> with the value for your selected host in the table:

npx oh-my-patent@latest adapt install --mode skill --tool <host>

Host	Skills CLI --agent / project CLI --tool	Manual Skill location in the workspace
Claude Code	claude-code	.claude/skills/oh-my-patent
Codex	codex	.agents/skills/oh-my-patent
OpenCode	opencode	.agents/skills/oh-my-patent

Skills CLI also accepts --agent <host> to select a host explicitly. The project CLI's Skill mode requires --tool <host>; plugin mode treats it as optional.

Standalone npm archive

Download the standalone npm package for packaging or manual deployment. Extract the archive and copy the complete package directory to your host's Skill location.

Keep SKILL.md, references/, assets/ and scripts/ together. Use the same installation method for updates and removal; see the installation guide.

Start a project

Open the same workspace in your selected host. For plugin mode, select Archimedes; for Skill mode, select oh-my-patent. Describe your topic, for example:

Create a patent project about homomorphic encryption in privacy-preserving computing.

Archimedes guides you through collecting material, developing ideas, drafting the disclosure and reviewing it. See compatibility for host-specific requirements, and the installation guide for source builds, version selection, updates and removal.

What you can do

Capability	What it gives you
Coordinate specialist agents	Research, ideation, patentability assessment, drafting, review, and technical responses under one orchestrator
Keep decisions traceable	Saved rounds, scores, innovation snapshots, and reasons in .brainstorm/; branch from a recorded node or restore an idea
Resume recorded work	Workflow state in .patent/state.json and agent outputs in references/ provide context for continuing a project
Generate patent figures	Specifications and editable SVG, optional local rendering or approved host image tools, with provenance and current review
Inspect progress	CLI queries, Markdown reports, a terminal UI, and environment checks

The project brings the disclosure, its supporting material, and its decision history together in one project directory. Rendering engines and retrieval services have their own setup requirements; see the usage guide.

From idea to disclosure

Overview of the ten stages, grouped by purpose. Arrows back to research and drafting show where further work may be needed.

Step	Workflow stages
Prepare and research	INIT → RESEARCH
Develop and assess ideas	BRAINSTORM_R1 → BRAINSTORM_R2
Write and illustrate	DRAFT → DIAGRAM_DRAFT
Review and revise	QA_LOOP → FINAL_REVIEW
Refresh figures and finish	DIAGRAM_FINAL → DONE

Review can return to earlier stages. The workflow reference shows the supported transitions and explains scoring decisions separately from stage changes.

How the team works

Pattern	Purpose
Orchestration	Archimedes coordinates specialists and carries project context between sta