Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
41 changes: 23 additions & 18 deletions CLAUDE.md

Large diffs are not rendered by default.

14 changes: 7 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,20 +8,18 @@

Automated installers and an environment configuration framework for Claude Code on Windows, macOS, and Linux.

Define your complete Claude Code environment in a single YAML file -- custom agents, MCP servers, slash commands, hooks, skills, model settings, and more -- and install everything with one command.
Define your complete Claude Code environment in a single YAML file -- custom agents, MCP servers, slash commands, hooks, skills, settings, and more -- and install everything with one command.

## Features

- **Custom agents** -- specialized subagents for code review, research, debugging, and any workflow you design
- **MCP servers** -- HTTP, SSE, and stdio transports with automatic permission pre-allowing
- **MCP servers** -- HTTP, SSE, and stdio transports with scope-based registration
- **Slash commands** -- custom commands for frequently used workflows
- **Rules** -- user-scope rule files for coding standards, security policies, and project conventions
- **Skills** -- multi-file skill packages for complex agent capabilities
- **System prompts** -- replace or append to the default Claude Code prompt
- **Hooks** -- four hook types: command (shell scripts), HTTP (webhooks), prompt (LLM evaluation), and agent (subagent with tools)
- **Permissions** -- fine-grained allow, deny, and ask rules for Claude Code tools and actions
- **Model and reasoning control** -- model selection, effort levels (low, medium, high, xhigh, max), thinking mode
- **User and global settings** -- direct control over `settings.json` and `~/.claude.json`
- **User and global settings** -- `user-settings` is raw `settings.json` content (camelCase keys) and `global-config` is raw `~/.claude.json` content, covering model selection, permissions, effort levels, thinking mode, environment variables, and every other Claude Code setting
- **Status line** -- custom status bar scripts for real-time session information
- **Configuration inheritance** -- extend and override parent configurations with selective per-key merge
- **Shared projects directory** -- optionally link an isolated profile's `projects/` to the base `~/.claude/projects/` so the isolated and default Claude share session history
Expand Down Expand Up @@ -61,8 +59,10 @@ mcp-servers:
# so the token stays in your environment, never in the config file.
header: "Authorization: Bearer ${CONTEXT_SERVER_TOKEN}"

model: "sonnet"
effort-level: "high"
# user-settings holds raw settings.json content with camelCase keys
user-settings:
model: "sonnet"
effortLevel: "high"

command-defaults:
system-prompt: "prompts/system-prompt.md"
Expand Down
4 changes: 2 additions & 2 deletions SECURITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,8 +4,8 @@

| Version | Supported |
|---------|--------------------|
| 5.x | :white_check_mark: |
| < 5.0 | :x: |
| 6.x | :white_check_mark: |
| < 6.0 | :x: |

> **Policy:** Only the latest major version receives security updates. When a new major version is released, prior major versions are immediately unsupported.

Expand Down
554 changes: 212 additions & 342 deletions docs/environment-configuration-guide.md

Large diffs are not rendered by default.

2 changes: 1 addition & 1 deletion docs/installing-claude-code.md
Original file line number Diff line number Diff line change
Expand Up @@ -158,7 +158,7 @@ To switch manually, uninstall the npm version with `npm uninstall -g @anthropic-

## Auto-Update Management

Auto-update management is handled by `setup_environment.py` via YAML configuration, not by the standalone installer. When `claude-code-version` is specified in a YAML environment configuration, `setup_environment.py` automatically manages auto-update controls across four targets.
Auto-update management is handled by `setup_environment.py` via YAML configuration, not by the standalone installer. When `claude-code-version` is specified in a YAML environment configuration, `setup_environment.py` automatically manages auto-update controls across three targets.

For version pinning with auto-update protection, use `setup_environment.py` with a YAML configuration specifying `claude-code-version`. See [Automatic Auto-Update Management](environment-configuration-guide.md#automatic-auto-update-management) in the Environment Configuration Guide.

Expand Down
Loading
Loading