agentihooks-bundle-example

An example agentihooks bundle — a single repo that holds all your Claude Code assets and identity profiles.

What is a bundle?

An agentihooks bundle is a portable collection of:

• .claude/ assets — slash commands, skills, agents, and coding rules that Claude Code loads globally
• profiles/ — named identities that configure how agentihooks starts Claude (model, permissions, MCP servers, OTEL telemetry)

The bundle is the single source of truth for your AI environment. Clone it on any machine, run the installer, and you have your full setup.

Structure

agentihooks-bundle-example/
├── .claude/                        # Global assets (shared across all profiles)
│   ├── agents/
│   │   └── code-reviewer.md        # Example sub-agent
│   ├── commands/
│   │   └── review-changes.md       # Example slash command  (/review-changes)
│   ├── rules/
│   │   └── coding-standards.md     # Example always-on coding rule
│   └── skills/
│       └── hello-world/
│           └── SKILL.md            # Example skill
├── profiles/
│   └── copilot/                    # One profile per identity/context
│       ├── profile.yml             # agentihooks reads this to configure the session
│       ├── CLAUDE.md               # Behavior rules injected into Claude's context
│       └── .claude/                # Profile-scoped assets (override global)
│           ├── .mcp.json           # MCP servers for this profile
│           ├── settings.overrides.json
│           ├── agents/
│           ├── commands/
│           ├── rules/
│           └── skills/
├── README.md
└── .gitignore

Profiles

Profile	Purpose
copilot	Generic coding assistant — lightweight, focused on code review and task planning

Add a new profile by creating profiles/<name>/profile.yml.

Global Assets

Type	File	Description
Agent	.claude/agents/code-reviewer.md	Sub-agent that reviews code for bugs and security issues
Command	.claude/commands/review-changes.md	/review-changes — diff + review of uncommitted work
Rule	.claude/rules/coding-standards.md	Always-on coding style guidance
Skill	.claude/skills/hello-world/SKILL.md	Minimal skill template you can fork

Install

Option A — agentihooks (recommended)

agentihooks bundle link ~/dev/agentihooks-bundle-example
agentihooks profile use copilot

This activates the copilot profile: sets your model, permissions, MCP servers, and injects CLAUDE.md into every session.

Option B — setup.sh (assets only)

git clone https://github.com/your-org/agentihooks-bundle-example
cd agentihooks-bundle-example
./setup.sh             # symlink .claude/ assets into ~/.claude/
./setup.sh --uninstall # remove only the symlinks created by this repo

• Recreates the full nested folder structure under ~/.claude/
• Skips files that already exist — never overwrites
• Uninstall only removes symlinks pointing to this repo — everything else is untouched

Contributing

This repo is an open-source example — PRs welcome.

• Add new example profiles under profiles/<name>/
• Add new example assets under .claude/<type>/
• Keep each file focused on one thing and well-commented
• Don't commit real credentials — use $ENV_VAR placeholders

License

MIT — see LICENSE.

---

How to Create Your Own Bundle

1. Fork or clone this repo
2. Edit profiles/copilot/profile.yml with your settings
3. Add or replace assets in .claude/ and profiles/copilot/.claude/
4. Run agentihooks bundle link <path> to activate

profile.yml Reference

name: my-profile
description: "What this profile is for"

# Which MCP server categories to enable (from your agentihooks gateway)
mcp_categories: coding          # or: all, none, [coding, search]

# Whitelist: only these MCP servers are active (overrides mcp_categories)
enabledMcpServers:
  - my-server

# OTEL telemetry (optional)
otel:
  enabled: false

# Claude session settings
claude:
  model: "claude-sonnet-4-6"
  permission_mode: default       # default | bypassPermissions | acceptEdits
  effort: medium                 # low | medium | high