dotagents CLI
dotagents is a Sentry CLI that wires skills, MCP servers, hooks and plugins from one agents.toml into each agent's folders.
- 263 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- Fetches skills, plugins and hooks from external repositories that shape agent behavior.
Install
- Works in
Manual install
npx @sentry/dotagents initThe first Quick Start command in the README runs through npx with no separate install.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Fetches skills, plugins and hooks from external repositories that shape agent behavior.
This is third-party code. Review the repository files before installing.
What it does
dotagents tracks agent dependencies in `agents.toml`: skills, MCP servers, hooks, subagents and plugins. The `install` command fetches them from GitHub, GitLab, any git server or a local folder and creates the links and configs that Claude, Cursor, Codex, GitHub Copilot CLI, Grok, VS Code, OpenCode and Pi expect. State is either global under `~/.agents/` or bound to a repository with the `--project` flag. An `agents.lock` file sits beside it, while `doctor` and `sync` check and repair what is installed.
Who it is for. Teams whose developers use different agents and want a shared skill set committed to the repository instead of copying folders by hand.
Good fit when
- Claude Code, Cursor and Codex all work in one repository and need the same skills.
- A new teammate clones the project and gets identical skills and MCP with one command.
- A skill is pinned to a release through `source = "owner/repo@v1.0.0"`.
- The team limits skill sources to a trusted list with `trust`.
Not a fit when
- You need one skill for one agent, where copying a folder is enough.
- You want a catalog to browse skills rather than a dependency manager.
- Node.js 20 is unavailable or a separate config is unwelcome.
Example request
Add the find-bugs skill from getsentry/skills to this repository through dotagents and check the state with doctor.Limitations
Requires Node.js 20 or newer. Skills and plugins come from external repositories and carry agent instructions, so read a source before installing and list trusted sources under `trust`. Hook and subagent support varies by agent, and the README table leaves dashes for some of them. For Pi, plugins install as a shared skill projection that other clients can also see. Name clashes between skills and the permissions of downloaded hooks remain your responsibility.
How to disable. Run `npx @sentry/dotagents remove <name>` for a skill or source. Global files live in `~/.agents/`; project files are `agents.toml` and `agents.lock` in the repository.
FAQ
How do global and project modes differ?
Without a flag, commands use `~/.agents/` and apply across projects. The `--project` flag keeps files inside the repository, and teammates run `dotagents --project install` after cloning.
Which agents are supported?
Claude, Cursor, Codex, GitHub Copilot CLI, Grok, VS Code, OpenCode and Pi. The `agents` field in `agents.toml` sets the list.
Where do skills come from?
From GitHub through the `owner/repo` shorthand, from GitLab, from any git server, from HTTPS sources and from local folders through `path:`.
How do I pin a version?
Add a ref after the `@` sign, for example `getsentry/skills@v1.0.0`.
How do I remove a skill?
`dotagents remove <name>` removes a skill or every dependency from a source, and the lock file entry is updated.
Discussion
No questions or reviews yet.
Related
CLI toolsA CLI that keeps instructions, commands, skills and MCP in .agents and links them into the configs of different agents
One config for Claude Code and Codex in every repo: shared rules, skill packs, second-model review and a destructive-command guard
The squads CLI runs teams of agents defined in markdown files in git: a lead briefs, workers act, a verifier checks.
A tmux-based TUI that runs Claude Code, Codex and other agents in one list: status, quick prompts, worktrees and diff review
A portable .agent folder with memory, skills and protocols that plugs into many coding agents and keeps its knowledge when you switch tools
A multi-agent harness that verifies results by artifacts: stop hooks, an independent judge and an event log for Claude Code, Codex, Cursor and more
Comparison with similar tools
Cards that share the main search query, and how they differ.
| Tool | Official | Repository stars | Main difference |
|---|---|---|---|
| dotagents (this card) | no | 263 | |
| skills (npx skills) | no | 39,131 | The skills CLI installs skills one by one; dotagents manages skills, MCP, hooks and subagents in a shared agents.toml with a lock file |
| Ruler | no | 2,968 | Ruler syncs rule files between agents; dotagents installs dependencies such as skills, plugins and MCP |
README in short
One `agents.toml` describes every agent dependency. Global mode is the default, project mode needs `--project`, and `doctor` repairs drift.