oh-my-cursor is a fork and derivative of oh-my-openagent by YeonGyu Kim (code-yeongyu). Upstream lives at https://github.com/code-yeongyu/oh-my-openagent.
Contributions are accepted under the Sustainable Use License 1.0 (SUL-1.0). By contributing, you agree your contributions will be licensed under the same terms as the project.
- Runtime: Bun. Do not use npm or yarn for project workflows described here.
- Language: TypeScript, with strict mode enabled.
- Install Bun:
curl -fsSL https://bun.sh/install | bash - Tests: From the
hooks/directory, runbun test(tests are co-located as*.test.tsfiles). - Lint: Follow standard TypeScript strict mode; fix type errors before opening a pull request.
oh-my-cursor is a Cursor IDE plugin, not a published Node.js package.
| Path | Purpose |
|---|---|
agents/ |
Agent definitions (Markdown) |
hooks/ |
Hook daemon and handlers (TypeScript) |
commands/ |
Slash commands (Markdown) |
rules/ |
Cursor rules (.mdc) |
skills/ |
Agent skills (Markdown) |
scripts/ |
Utility scripts |
.cursor-plugin/ |
Plugin manifest |
- Fork this repository.
- Create a feature branch from the appropriate base branch.
- Make focused changes with clear commit messages.
- Run
bun testfromhooks/before you submit. - Open a pull request that describes the change and any testing you ran.
- Match patterns already used in the codebase.
- Use kebab-case for file names.
- Avoid AI-style comment noise (obvious restatements of what the code does).
- Prefer semantic commit messages:
type: short imperative summary(for example,fix: handle empty hook payload).