eagle-bootstrap

Configure Claude Code global settings, hooks, and Obsidian vault integration.

3|Updated Mar 25, 2026
One-click install
npx skills add https://github.com/eagleisbatman/eagle-skills --skill eagle-bootstrap-eagleisbatman
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: eagle-bootstrap
Source: https://github.com/eagleisbatman/eagle-skills/tree/main/eagle-bootstrap
Command: npx skills add https://github.com/eagleisbatman/eagle-skills --skill eagle-bootstrap-eagleisbatman

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill removes the hassle of manually configuring Claude Code’s global environment by performing one-time, idempotent setup steps: wiring token-saving hooks, enriching behavioral rules, pointing to your Obsidian vault, and verifying Eagle agents are installed.

Core Features & Use Cases

  • Idempotent global setup: Safely re-runs on the same machine without duplicating hooks or overwriting existing user config.
  • Behavioral rules injection: Appends a “Behavioral Rules” section into ~/.claude/CLAUDE.md without modifying existing content.
  • Compact hook installation: Installs compact.sh, compact-filter.sh, and compact-rules.json, then merges a PreToolUse hook into ~/.claude/settings.json if missing.
  • Obsidian vault path configuration: Detects an existing vault path (or prompts you), writes it to ~/.claude/eagle-config.json, and ensures <vault>/projects exists.
  • Agent verification: Checks that the expected ~/.claude/agents agent files are present and reports what’s missing for follow-up installation.

Quick Start

Run the command eagle bootstrap to configure your Claude Code environment on this machine.

Frequently Asked Questions about eagle-bootstrap

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up Claude Code global environment on a new machine?▼

To set up Claude Code globally, run the bootstrap command to safely append behavioral rules to ~/.claude/CLAUDE.md, install token-saving hooks, and configure your Obsidian vault path without overwriting existing configurations.

Does configuring PreToolUse hooks in Claude Code overwrite existing settings?▼

No, configuring PreToolUse hooks does not overwrite existing settings. The setup process uses jq to safely merge hook configurations into ~/.claude/settings.json, ensuring idempotent checks that prevent duplication on re-runs.

Can I integrate an Obsidian vault with Claude Code for project workflows?▼

Yes, you can integrate an Obsidian vault by detecting or prompting for the vault path, writing it to ~/.claude/eagle-config.json, and ensuring the projects directory exists within the vault for eagle-skills workflows.

What are token-saving hooks in Claude Code and how do they work?▼

Token-saving hooks in Claude Code are compact scripts like compact.sh and compact-filter.sh paired with compact-rules.json. They execute during PreToolUse events to reduce context size, saving tokens during agent workflows.

How to verify Claude Code agents are installed correctly?▼

To verify Claude Code agents, execute an idempotent check that scans the ~/.claude/agents directory for expected agent files, reporting exactly what is missing so you can perform follow-up installations.