@indy2kro/agentenv 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cristian Radu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,320 @@
+# agentenv
+
+> Give AI coding agents a consistent, capable shell environment on Windows,
+> macOS, and Linux — with minimal setup friction, and without maintaining any
+> dev tools yourself.
+
+`agentenv` is a thin orchestration + config layer on top of
+[mise](https://mise.jdx.dev) (tool installation), [rtk](https://github.com/rtk-ai/rtk)
+(command rewriting + hooks), and [AGENTS.md](https://agents.md) (repo-level
+instructions). It never re-implements any dev tool — it just drives mise/rtk
+and writes config files for you.
+
+It targets four AI coding agents: **Claude Code**, **OpenAI Codex CLI**,
+**GitHub Copilot** (CLI/Chat), and **OpenCode**.
+
+> **⚠️ Not yet published to npm.** `npm install -g agentenv` does not work
+> yet — see [Install](#install) below for installing from source in the
+> meantime. Everything else in this guide (commands, config, tool catalog)
+> already works once you've built it locally.
+
+## Contents
+
+- [Why agentenv](#why-agentenv)
+- [Requirements](#requirements)
+- [Install](#install)
+- [Quick start](#quick-start)
+- [Commands](#commands)
+- [Configuration (`agentenv.toml`)](#configuration-agentenvtoml)
+- [Tool catalog](#tool-catalog)
+- [Custom tools](#custom-tools)
+- [Optional integrations (experimental, not yet active)](#optional-integrations-experimental-not-yet-active)
+- [Troubleshooting](#troubleshooting)
+- [Development](#development)
+- [What's still missing](#whats-still-missing)
+
+## Why agentenv
+
+If you've ever had an AI coding agent fumble because `grep`/`fd`/`jq` weren't
+on PATH, or watched every agent redo the same hook-wiring dance for a
+different config file format, that's what this fixes:
+
+- **One command** (`agentenv setup`) gets a fresh machine — Windows included
+  — to a working state for whichever of the four agents you have installed.
+- **A single source of truth** (`agentenv.toml`) drives everything else:
+  `mise.toml`, `AGENTS.md`/`CLAUDE.md`, and each agent's own hook files are
+  all generated from it, never hand-maintained.
+- **Nothing is reinstalled or reinvented.** Tool installation is 100% mise;
+  command rewriting/hooks are 100% rtk. agentenv only ever calls out to them
+  and writes config.
+- **Safe to re-run.** `agentenv apply` is idempotent — run it as often as you
+  like; with no config change it touches nothing and reinstalls nothing.
+
+## Requirements
+
+- **Node.js >= 22.13** to run the CLI itself.
+- **[mise](https://mise.jdx.dev)** installed and on PATH — agentenv generates
+  a `mise.toml` and delegates all tool installation to it. Without mise,
+  `agentenv apply`/`setup` can still generate config files but can't install
+  anything.
+- **Git for Windows**, if you're on Windows — agentenv's Tier 0 shell fix
+  relies on the POSIX toolchain it bundles.
+- Optionally, whichever of the four agents you want configured already
+  installed (agentenv detects what's present; it doesn't install the agents
+  themselves).
+
+## Install
+
+### From source (works today)
+
+```sh
+git clone https://github.com/indy2kro/agentenv.git
+cd agentenv/cmd/agentenv
+npm install
+npm run build
+npm link          # makes `agentenv` available globally on PATH
+```
+
+`npm link` symlinks this checkout's `dist/index.js` as the global `agentenv`
+binary — rerun `npm run build` after pulling changes, no need to `npm link`
+again. Prefer not to touch global state? Run it in place instead:
+
+```sh
+node dist/index.js setup
+```
+
+### From npm (coming soon)
+
+```sh
+npm install -g agentenv
+```
+
+This will work once the package is published — see
+[What's still missing](#whats-still-missing).
+
+## Quick start
+
+```sh
+agentenv setup
+```
+
+This is Simple mode: it auto-detects which of the four agents are installed,
+offers the default tool set (Tier 1 always, Tier 2 unless you decline),
+writes `agentenv.toml`, and wires everything up in one pass — including the
+Windows shell fix if you're on Windows. Answer three prompts (agents, Tier 2
+on/off, project vs. user scope) and you're done.
+
+Prefer full control over exactly which tools and agents get configured?
+Run `agentenv configure` instead (see [Commands](#commands)).
+
+Not in an interactive terminal (CI, a script)? `setup`/`configure` both
+refuse to run and tell you to use `agentenv apply` against a hand-written or
+previously-saved `agentenv.toml` instead.
+
+## Commands
+
+| Command | What it does |
+|---|---|
+| `agentenv setup` | Interactive first-run wizard, Simple mode: detect agents, pick Tier 1(+2) tools, pick scope, then applies immediately. |
+| `agentenv configure` | Interactive Advanced-mode wizard: pick agents, the full Tier 1–3 tool picker, add custom binaries, choose scope, toggle rtk, review a diff of what will change, then confirm before applying. Re-run any time — it pre-fills every prompt from your current `agentenv.toml`. |
+| `agentenv apply [--skip-mise-install]` | Non-interactive: read `agentenv.toml` and (re)generate everything — `mise.toml`, `AGENTS.md`/`CLAUDE.md`, per-agent hook files, the Tier 0 shell fix. Safe to run in CI or a script. `--skip-mise-install` generates files only, without running `mise install` (useful for a fast dry-run or when mise isn't available). |
+| `agentenv status` | Read-only report: what's configured, what's actually installed, and where the two disagree (drift) — per agent, per tool, per generated file. |
+| `agentenv --version` / `agentenv --help` | Standard `commander`-generated version/help output; every subcommand also takes `--help`. |
+
+`setup`/`configure` both write `agentenv.toml` and then call the same
+`apply` logic internally, so the end state is identical either way — the
+only difference is how you got there.
+
+## Configuration (`agentenv.toml`)
+
+Everything flows from one file. It lives either in the project root
+(`./agentenv.toml`, scope = `"project"`, committed to the repo so your whole
+team shares it) or in your user config dir
+(`~/.config/agentenv/agentenv.toml` — or the Windows equivalent via
+`%USERPROFILE%`, scope = `"user"`). `agentenv apply`/`status` look in the
+project directory first, then fall back to the user-scope file.
+
+`mise.toml`, `AGENTS.md`, `CLAUDE.md`, and the per-agent hook files are all
+**generated outputs** of `agentenv apply` — never hand-edit them; edit
+`agentenv.toml` and re-run `apply` (or `configure`) instead. Regeneration
+only touches a marker-block section of `AGENTS.md`/`CLAUDE.md`, so any
+content you've added outside that block survives.
+
+Full annotated example:
+
+```toml
+# "project" (default, committed to the repo) or "user" (global, ~/.config/agentenv/)
+scope = "project"
+
+[agents]
+claude_code = true
+codex_cli   = true
+copilot     = true
+opencode    = true
+
+[tools]
+# Tier 1 (essential, on by default)
+ripgrep = true
+fd      = true
+jq      = true
+rtk     = true
+# Tier 2 (AI-coding value-add, on by default)
+ast_grep   = true
+git_delta  = true
+gh         = true
+difftastic = true
+# Tier 3 (power-user, off by default) — see the Tool catalog below for the full list
+yq = false
+bat = false
+# ...
+
+# Your own tool, already installed somewhere on the machine
+[[custom_tools]]
+name = "mytool"
+description = "Internal linter wrapper"
+already_installed = true
+path_windows = "C:\\tools\\mytool.exe"
+path_macos   = "/usr/local/bin/mytool"
+path_linux   = "/usr/local/bin/mytool"
+
+# Your own tool, installable via mise (e.g. it publishes GitHub releases)
+[[custom_tools]]
+name = "otherthing"
+mise_source = "github:someorg/otherthing"
+version = "latest"
+
+[rtk]
+enabled = true
+[rtk.init]
+claude_code = true
+codex_cli   = true
+copilot     = true
+opencode    = true
+
+[tier0]
+check_enabled = true   # Windows POSIX-shell fix; set false to skip it
+
+[generate]
+marker_start = "<!-- agentenv-managed-start -->"
+marker_end   = "<!-- agentenv-managed-end -->"
+files = ["AGENTS.md", "CLAUDE.md"]
+
+# See "Optional integrations" below — this section is parsed and validated
+# today, but agentenv apply/status do not act on it yet.
+[integrations.superpowers]
+enabled = false
+```
+
+Every field is optional — omit anything and it falls back to the documented
+default. Run `agentenv configure` if you'd rather build this file
+interactively than hand-write it; the review screen at the end shows you the
+exact diff before anything is written.
+
+## Tool catalog
+
+| Tier | Tools | Default |
+|---|---|---|
+| **1 — essential** | `ripgrep` (rg), `fd`, `jq`, `rtk` | always on |
+| **2 — AI-coding value-add** | `ast_grep` (sg), `git_delta` (delta), `gh`, `difftastic` (difft) | on (Simple mode asks once) |
+| **3 — power-user** | `universal_ctags`, `yq`, `bat`, `eza`, `miller` (mlr), `tokei`, `hyperfine`, `fzf`, `just`, `watchexec`, `direnv` | off — pick individually via `agentenv configure` |
+
+All of Tiers 1–3 install through mise the same way — no separate mechanism.
+Two tools (`universal_ctags`, `tokei`) aren't in mise's registry on every
+platform; enabling them prints a validation warning suggesting a
+`custom_tools` fallback entry instead.
+
+## Custom tools
+
+Anything not in the catalog — an internal CLI, a niche tool, anything you
+already have — goes in `[[custom_tools]]` (see the example above). Two
+supported shapes:
+
+- **Already installed:** `already_installed = true` plus whichever of
+  `path_windows`/`path_macos`/`path_linux` apply. `agentenv status` checks
+  the path for your current OS and flags it if missing.
+- **Installable via mise:** `mise_source = "github:owner/repo"` (mise's
+  generic backend, works for most tools that publish GitHub release
+  archives) plus an optional `version` (defaults to `"latest"`).
+
+Custom tools flow through the exact same "config changed → regenerate
+`AGENTS.md`/hooks" pipeline as catalog tools.
+
+## Optional integrations (experimental, not yet active)
+
+`agentenv.toml` has a `[integrations.superpowers]` section for optionally
+installing [Superpowers](https://github.com/obra/superpowers) — a
+third-party Claude Code skill/methodology plugin — through its own
+documented installer, never bundled or forked. The schema is fully
+implemented today (validation, defaults, `agentenv configure`'s pending
+opt-in step) but **`agentenv apply`/`status` do not act on it yet** — setting
+`enabled = true` today parses and validates cleanly but has no effect. See
+[What's still missing](#whats-still-missing).
+
+When it lands, only Claude Code will get a fully automated install (via
+`claude plugin marketplace add` / `claude plugin install`, pinned to a
+specific `ref`) — Codex CLI, Copilot, and OpenCode have no safe
+non-interactive installer documented upstream today, so they'll always
+report "unsupported" with manual-install instructions instead. See
+[`docs/research/superpowers-install-mechanisms.md`](../../docs/research/superpowers-install-mechanisms.md)
+for why.
+
+`agentenv` also never touches GitHub credentials: a `gh` auth-status probe
+(`gh auth status --hostname github.com`, read-only, never `gh auth login`)
+exists in the codebase but — like the rest of this section — isn't wired
+into `agentenv status`'s output yet either.
+
+## Troubleshooting
+
+- **`agentenv setup`/`configure` exits immediately saying it's
+  interactive** — you're running it in a non-TTY context (CI, a piped
+  script). Use `agentenv apply` against a config file instead.
+- **A tool shows as enabled in `agentenv status` but not found on PATH** —
+  run `agentenv apply` (it calls `mise install`), or check that mise itself
+  is installed and on PATH. `--skip-mise-install` intentionally leaves tools
+  uninstalled; don't use it for your real run.
+- **Windows: agents aren't picking up ripgrep/fd/etc.** — check the "Tier 0
+  (shell)" block in `agentenv status`. If it reports not POSIX-compatible,
+  re-run `agentenv apply`; if Git Bash truly isn't installed, install
+  [Git for Windows](https://gitforwindows.org) first.
+- **A hook file has content you added by hand, and you're worried `apply`
+  will clobber it** — it won't. Regeneration only replaces the marker-block
+  section (`<!-- agentenv-managed-start -->` … `<!-- agentenv-managed-end
+  -->`); everything else in the file is left alone.
+- **`agentenv apply` reports a validation error and refuses to run** — fix
+  the listed field in `agentenv.toml`; errors block `apply` deliberately
+  (warnings don't).
+
+## Development
+
+```sh
+npm install
+npm run build   # tsc -> dist/
+npm test        # build + node:test suites
+npm run lint    # eslint --max-warnings 0
+npm run format:check
+```
+
+See [`docs/guides/adding-an-adapter.md`](../../docs/guides/adding-an-adapter.md)
+for wiring in a fifth agent, and
+[`docs/plans/agentenv-dev-plan.md`](../../docs/plans/agentenv-dev-plan.md)
+for the full design, config schema rationale, and phase roadmap.
+
+## What's still missing
+
+- **npm publish.** The package is not yet on the npm registry —
+  `npm install -g agentenv` doesn't work today; install
+  [from source](#install) instead. (Needs npm publish credentials on a
+  maintainer's machine; everything else — `npm pack`, a real
+  `npm install -g` from a tarball, CI — is already verified working.)
+- **Optional integrations aren't wired up yet.** The `[integrations.superpowers]`
+  config schema, its Claude Code installer adapter, and the read-only `gh`
+  auth probe all exist and are tested, but nothing in `apply`, `status`,
+  `setup`, or `configure` calls them yet — see
+  [Optional integrations](#optional-integrations-experimental-not-yet-active)
+  above. Tracked in
+  [`docs/plans/agentenv-dev-plan.md`](../../docs/plans/agentenv-dev-plan.md)
+  Phase 6.
+
+## License
+
+MIT

package/dist/adapters/base.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Base Adapter Interface
+ * Defines the common interface for all agent adapters
+ */
+import type { RtkInitFn } from '../toolchain/rtk.js';
+export interface AdapterConfig {
+    enabled: boolean;
+    baseDir: string;
+    rtkEnabled?: boolean;
+    /** Injectable `rtk init` runner; defaults to the real rtk binary. */
+    rtkInit?: RtkInitFn;
+}
+export interface AdapterResult {
+    success: boolean;
+    message: string;
+    filesCreated: string[];
+    filesModified: string[];
+    errors: string[];
+}
+export interface HookConfig {
+    name: string;
+    type: 'pre' | 'post' | 'session' | 'tool';
+    command: string;
+    description: string;
+}
+export declare abstract class BaseAdapter {
+    protected config: AdapterConfig;
+    constructor(config: AdapterConfig);
+    /**
+     * Initialize the adapter
+     */
+    abstract initialize(): Promise<AdapterResult>;
+    /**
+     * Configure hooks for the agent
+     */
+    abstract configureHooks(): Promise<AdapterResult>;
+    /**
+     * Get the agent name
+     */
+    abstract getName(): string;
+    /**
+     * Check if the agent is installed
+     */
+    abstract isInstalled(): boolean;
+    /**
+     * Get the agent's configuration directory
+     */
+    abstract getConfigDir(): string;
+    /**
+     * Clean up any generated files
+     */
+    abstract cleanup(): Promise<AdapterResult>;
+    /**
+     * Get agent-specific environment variables
+     */
+    getEnvVars(): Record<string, string>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/adapters/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/adapters/base.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,qEAAqE;IACrE,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,8BAAsB,WAAW;IAC/B,SAAS,CAAC,MAAM,EAAE,aAAa,CAAC;gBAEpB,MAAM,EAAE,aAAa;IAIjC;;OAEG;IACH,QAAQ,CAAC,UAAU,IAAI,OAAO,CAAC,aAAa,CAAC;IAE7C;;OAEG;IACH,QAAQ,CAAC,cAAc,IAAI,OAAO,CAAC,aAAa,CAAC;IAEjD;;OAEG;IACH,QAAQ,CAAC,OAAO,IAAI,MAAM;IAE1B;;OAEG;IACH,QAAQ,CAAC,WAAW,IAAI,OAAO;IAE/B;;OAEG;IACH,QAAQ,CAAC,YAAY,IAAI,MAAM;IAE/B;;OAEG;IACH,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC;IAE1C;;OAEG;IACH,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;CAGrC"}

package/dist/adapters/base.js

@@ -0,0 +1,16 @@
+/**
+ * Base Adapter Interface
+ * Defines the common interface for all agent adapters
+ */
+export class BaseAdapter {
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Get agent-specific environment variables
+     */
+    getEnvVars() {
+        return {};
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/adapters/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/adapters/base.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA2BH,MAAM,OAAgB,WAAW;IAG/B,YAAY,MAAqB;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAgCD;;OAEG;IACH,UAAU;QACR,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}

package/dist/adapters/claude.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Claude Code Adapter
+ * Handles Claude Code-specific configuration and hook setup
+ */
+import { BaseAdapter, AdapterConfig, AdapterResult } from './base.js';
+export declare class ClaudeCodeAdapter extends BaseAdapter {
+    private configDir;
+    constructor(config: AdapterConfig);
+    getName(): string;
+    getConfigDir(): string;
+    isInstalled(): boolean;
+    initialize(): Promise<AdapterResult>;
+    configureHooks(): Promise<AdapterResult>;
+    cleanup(): Promise<AdapterResult>;
+    getEnvVars(): Record<string, string>;
+    /**
+     * Generate CLAUDE.md content
+     */
+    private generateClaudeMdContent;
+}
+//# sourceMappingURL=claude.d.ts.map

package/dist/adapters/claude.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.d.ts","sourceRoot":"","sources":["../../src/adapters/claude.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAGtE,qBAAa,iBAAkB,SAAQ,WAAW;IAChD,OAAO,CAAC,SAAS,CAAS;gBAEd,MAAM,EAAE,aAAa;IAMjC,OAAO,IAAI,MAAM;IAIjB,YAAY,IAAI,MAAM;IAItB,WAAW,IAAI,OAAO;IAIhB,UAAU,IAAI,OAAO,CAAC,aAAa,CAAC;IA2CpC,cAAc,IAAI,OAAO,CAAC,aAAa,CAAC;IAqFxC,OAAO,IAAI,OAAO,CAAC,aAAa,CAAC;IA8CvC,UAAU,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAWpC;;OAEG;IACH,OAAO,CAAC,uBAAuB;CAmBhC"}

package/dist/adapters/claude.js

@@ -0,0 +1,198 @@
+/**
+ * Claude Code Adapter
+ * Handles Claude Code-specific configuration and hook setup
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { BaseAdapter } from './base.js';
+import { isAgentInstalled } from './detect.js';
+export class ClaudeCodeAdapter extends BaseAdapter {
+    constructor(config) {
+        super(config);
+        const home = process.env.HOME || process.env.USERPROFILE || '';
+        this.configDir = path.join(home, '.claude');
+    }
+    getName() {
+        return 'Claude Code';
+    }
+    getConfigDir() {
+        return this.configDir;
+    }
+    isInstalled() {
+        return isAgentInstalled('claude_code');
+    }
+    async initialize() {
+        const result = {
+            success: true,
+            message: '',
+            filesCreated: [],
+            filesModified: [],
+            errors: [],
+        };
+        if (!this.config.enabled) {
+            result.message = 'Claude Code adapter not enabled';
+            return result;
+        }
+        // Create config directory if it doesn't exist
+        try {
+            if (!fs.existsSync(this.configDir)) {
+                fs.mkdirSync(this.configDir, { recursive: true });
+                result.filesCreated.push(this.configDir);
+            }
+        }
+        catch (err) {
+            result.success = false;
+            result.errors.push(`Failed to create config directory: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        // Initialize settings.json with RTK hooks if enabled
+        if (this.config.rtkEnabled) {
+            const hookResult = await this.configureHooks();
+            if (hookResult.success) {
+                result.filesCreated.push(...hookResult.filesCreated);
+                result.filesModified.push(...hookResult.filesModified);
+            }
+            else {
+                result.success = false;
+                result.errors.push(...hookResult.errors);
+            }
+        }
+        result.message = 'Claude Code adapter initialized';
+        return result;
+    }
+    async configureHooks() {
+        const result = {
+            success: true,
+            message: '',
+            filesCreated: [],
+            filesModified: [],
+            errors: [],
+        };
+        if (!this.config.enabled) {
+            result.message = 'Claude Code adapter not enabled';
+            return result;
+        }
+        const settingsPath = path.join(this.configDir, 'settings.json');
+        // Claude Code stores hooks by event, then matcher. This matches the
+        // structure written by `rtk init` and preserves existing hook entries.
+        const rtkHook = {
+            matcher: 'Bash',
+            hooks: [{ type: 'command', command: 'rtk hook claude' }],
+        };
+        try {
+            let settings = {};
+            // Load existing settings if they exist
+            if (fs.existsSync(settingsPath)) {
+                const content = fs.readFileSync(settingsPath, 'utf-8');
+                try {
+                    settings = JSON.parse(content);
+                }
+                catch {
+                    // Invalid JSON, start fresh
+                    settings = {};
+                }
+            }
+            if (!settings.hooks || Array.isArray(settings.hooks))
+                settings.hooks = {};
+            if (!Array.isArray(settings.hooks.PreToolUse))
+                settings.hooks.PreToolUse = [];
+            // Check if RTK hook already exists
+            const hasRtkHook = settings.hooks.PreToolUse.some((entry) => entry.matcher === 'Bash' &&
+                entry.hooks?.some((hook) => hook.command === 'rtk hook claude'));
+            if (!hasRtkHook) {
+                settings.hooks.PreToolUse.push(rtkHook);
+            }
+            // Save settings
+            fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+            if (!hasRtkHook) {
+                result.filesModified.push(settingsPath);
+                result.message = `Added RTK PreToolUse hook to Claude Code settings at ${settingsPath}`;
+            }
+            else {
+                result.message = `RTK hook already exists in Claude Code settings`;
+            }
+        }
+        catch (err) {
+            result.success = false;
+            result.errors.push(`Failed to configure Claude Code hooks: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        // Also create CLAUDE.md pointing to AGENTS.md
+        const claudeMdPath = path.join(this.config.baseDir, 'CLAUDE.md');
+        try {
+            const claudeMdContent = this.generateClaudeMdContent();
+            if (!fs.existsSync(claudeMdPath)) {
+                fs.writeFileSync(claudeMdPath, claudeMdContent);
+                result.filesCreated.push(claudeMdPath);
+            }
+        }
+        catch (err) {
+            result.errors.push(`Failed to create CLAUDE.md: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        return result;
+    }
+    async cleanup() {
+        const result = {
+            success: true,
+            message: '',
+            filesCreated: [],
+            filesModified: [],
+            errors: [],
+        };
+        const settingsPath = path.join(this.configDir, 'settings.json');
+        try {
+            if (fs.existsSync(settingsPath)) {
+                let settings = {};
+                const content = fs.readFileSync(settingsPath, 'utf-8');
+                try {
+                    settings = JSON.parse(content);
+                }
+                catch {
+                    return result;
+                }
+                // Remove RTK hooks
+                if (Array.isArray(settings.hooks?.PreToolUse)) {
+                    settings.hooks.PreToolUse = settings.hooks.PreToolUse.filter((entry) => !(entry.matcher === 'Bash' &&
+                        entry.hooks?.some((hook) => hook.command === 'rtk hook claude')));
+                    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+                    result.filesModified.push(settingsPath);
+                }
+            }
+        }
+        catch (err) {
+            result.success = false;
+            result.errors.push(`Failed to cleanup Claude Code: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        result.message = 'Claude Code adapter cleaned up';
+        return result;
+    }
+    getEnvVars() {
+        const env = {};
+        // Set SHELL to bash.exe on Windows if RTK is enabled
+        if (process.platform === 'win32' && this.config.rtkEnabled) {
+            env.SHELL = 'bash.exe';
+        }
+        return env;
+    }
+    /**
+     * Generate CLAUDE.md content
+     */
+    generateClaudeMdContent() {
+        return `# CLAUDE.md
+
+This file provides Claude Code-specific instructions.
+
+## General Instructions
+
+Please see [AGENTS.md](./AGENTS.md) for the complete list of AI agent instructions.
+
+The instructions in AGENTS.md apply to Claude Code as well.
+
+## Claude Code Specific Notes
+
+- AGENTS.md is the source of truth for tool availability and usage instructions
+- All tools listed in AGENTS.md are available for use
+- RTK hooks are configured to optimize command execution
+- Use RTK-optimized commands for better performance and token efficiency
+`;
+    }
+}
+//# sourceMappingURL=claude.js.map

package/dist/adapters/claude.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude.js","sourceRoot":"","sources":["../../src/adapters/claude.ts"],"names":[],"mappings":"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"}