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.