dotagentsOne Config for Your Coding Agents

Declare skills, MCP servers, and hooks in agents.toml. dotagents installs shared skills and writes each tool's local config.

Get Started

agents.toml

version = 1
agents = ["claude", "cursor", "codex", "vscode"]

[trust]
github_orgs = ["getsentry"]

[[skills]]
name = "find-bugs"
source = "getsentry/skills"

[[skills]]
name = "commit"
source = "getsentry/skills"

What dotagents manages

Keep generated agent state out of git. Commit one TOML file, then let each developer install the same skills and config locally.

SkillsInstall SKILL.md directories from GitHub, GitLab, git URLs, well-known HTTPS sources, or local paths.MCP serversDeclare stdio and HTTP servers once, including environment variables and headers.HooksGenerate hook config for supported agents and refresh local state after pulls.Trust policyRestrict skill sources before dotagents performs any network operation.

Quick Start

Run init at the root of your repository. Interactive setup asks which agent tools to configure, writes agents.toml, gitignores generated files, and declares the dotagents skill from getsentry/dotagents.

$ npx @sentry/dotagents init

Created agents.toml
Created .agents/skills/
Updated .gitignore

Next:
dotagents add getsentry/skills find-bugs
dotagents install

Supported Agents

The agents array tells dotagents which tools to configure. Pi reads .agents/skills/ directly and does not need generated config.

Agent	Config Dir	MCP Config	Hooks
`claude`	`.claude`	`.mcp.json`	`.claude/settings.json`
`cursor`	`.cursor`	`.cursor/mcp.json`	`.cursor/hooks.json`
`codex`	`.codex`	`.codex/config.toml`	None
`vscode`	`.vscode`	`.vscode/mcp.json`	`.claude/settings.json`
`opencode`	`.claude`	`opencode.json`	None

Adding Skills

dotagents discovers skills in a source. When a repo has one skill, it adds it automatically. When multiple are found, pass skill names or use --all.

# Add a single skill from a GitHub repo
dotagents add getsentry/skills find-bugs

# Add all skills from a repo
dotagents add getsentry/skills --all

# Pin to a specific ref
dotagents add getsentry/warden@v1.0.0

# Add from GitLab
dotagents add https://gitlab.com/group/repo find-bugs

# From a well-known HTTPS source
dotagents add https://cli.sentry.dev error-tracking

Shorthand owner/repo resolves using defaultRepositorySource in agents.toml (default: github).