@buffbirb/unclaude 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 aisetup author
+
+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,121 @@
+# unclaude
+
+An opinionated AI project setup script with a TUI and CLI.
+
+## Why?
+
+Do you make VSCode your commit author? Do you write "sent from my dell xps" in your PRs? If not, then maybe you take issue with AI agents leaving their dirty footprints all over your git history. A simple change to `.claude/settings.json` will patch your local setup, but cloud agents need a wider array of fixes.
+
+I also added a few broadly useful tools to cut tokens and leverage SDD, which I have been adding in nearly every project lately. You can pick only what you need.
+
+## Quick start
+
+Recommended for local installs, launch the TUI:
+
+```sh
+npx unclaude
+```
+
+Recommended for cloud pre-session installs, run in CLI mode:
+
+```sh
+npx unclaude install --git-user "Your Name" --git-email "you@example.com"
+```
+
+If the cloud agent doesn't support pre-session scripts, run locally with `.gitignore` disabled and commit to the repo.
+
+## Features
+
+| Feature | What it does |
+|---|---|
+| **Stop Telemetry** | Exports `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1` in `~/.airc` |
+| **Agent config for git commits** | Sets `attribution: { commit: '', pr: '' }` in Claude Code `settings.json` |
+| **Git pre-commit hook for git commits** | Installs a `commit-msg` git hook that strips `🤖 Generated with Claude Code`, `Co-Authored-By: Claude`, session URLs, and lone `---` separators |
+| **Agent SessionStart hook for git commits** | Registers a Claude Code `SessionStart` hook that installs a bash `commit-msg` hook in `.git/hooks` at the start of every session |
+| **Agent SessionStart hook for git branches** | Registers a Claude Code `SessionStart` hook that renames `claude/*` or `claude-*` branches to a custom prefix (or removes the prefix) |
+| **GitHub Action for PR body** | Writes a workflow that strips Claude attribution from PR bodies server-side on `opened`/`edited` |
+| **Agent md file for all git ops** | Appends attribution rules to `CLAUDE.md` (Claude Code) or `AGENTS.md` (OpenCode) |
+| **LSP** | Enables `ENABLE_LSP_TOOL` in Claude Code settings; installs clangd-lsp / swift-lsp plugins; adds clangd to `~/.airc` PATH; enables LSP in OpenCode config |
+| **Headroom** | Installs headroom via uv; writes `hclaude` and `hopencode` wrapper scripts to `/usr/local/bin`; adds a `headroom_start` function to `~/.airc` |
+| **OpenSpec** | Installs `@fission-ai/openspec` globally via npm; optionally runs `openspec init` in the current directory |
+
+### Feature matrix
+
+| Feature | Agents | Scope |
+|---|---|---|
+| Stop Telemetry | Claude Code | Global |
+| Agent config for git commits | Claude Code | Global, Project |
+| Git pre-commit hook for git commits¹ | Claude Code, OpenCode | Project |
+| Agent SessionStart hook for git commits | Claude Code | Project |
+| Agent SessionStart hook for git branches | Claude Code | Project |
+| GitHub Action for PR body | Claude Code, OpenCode | Project |
+| Agent md file for all git ops | Claude Code, OpenCode | Global, Project |
+| LSP | Claude Code, OpenCode | Global |
+| Headroom | Claude Code, OpenCode | Global |
+| OpenSpec | Claude Code, OpenCode | Global (install), Project (init) |
+
+¹ Git pre-commit hook can be set globally, but it's intentionally restricted to project-scope in this installer.
+
+### Personalization
+
+If you select certain features, a second screen asks whether to personalize the setup to your identity.
+
+| Field | Purpose |
+|---|---|
+| **Git user** | Your `user.name` (prefilled from `git config --global user.name`). Used by the **Agent SessionStart hook for git commits** and **Agent md file for all git ops**. |
+| **Git email** | Your `user.email` (prefilled from `git config --global user.email`). Used by the **Agent SessionStart hook for git commits** and **Agent md file for all git ops**. |
+| **Branch prefix** | Prepended to renamed `claude/*` branches (e.g., `username/foo`). Used by the **Agent SessionStart hook for git branches**. |
+
+This is most useful in **managed cloud environments** (e.g., Claude Code Web) where the AI does not have access to your local git configuration. By embedding your identity, commits and branch metadata are authored under your name rather than an AI-generated default.
+
+> **Note:** Commits will still show as **unverified** on GitHub / GitLab because most cloud providers do not offer a secure place to store a GPG or SSH signing key.
+
+### Git Settings
+
+Currently only `.gitignore` is amended with a section covering generated attribution-related files.
+
+## CLI arguments
+
+Running with no arguments launches the interactive TUI. Pass a subcommand for non-interactive use:
+
+```sh
+unclaude install   [--agents <list>] [--scopes <list>] [--features <list>] [--gitignore]
+                   [--git-user <name>] [--git-email <email>] [--branch-prefix <prefix>]
+unclaude uninstall [--agents <list>] [--scopes <list>] [--features <list>] [--gitignore]
+```
+
+Each list option takes a comma-separated value. Omitting a list option defaults to all valid values.
+
+| Option | Description |
+|---|---|
+| `--agents` | `claudeCode`, `openCode` |
+| `--scopes` | `global`, `project` |
+| `--features` | `stopTelemetry`, `stopAttributionConfig`, `stopAttributionHook`, `stripCommitAttribution`, `renameClaudeBranch`, `stripPrAttribution`, `agentMdFile`, `lsp`, `headroom`, `openspec` |
+| `--no-gitignore` | Skip adding generated project-scope files to `.gitignore` (default: adds them) |
+| `--git-user` | Your `user.name` — embedded in hooks and agent md files |
+| `--git-email` | Your `user.email` — embedded in hooks and agent md files |
+| `--branch-prefix` | Prefix for renamed `claude/*` branches (e.g. `username`) |
+
+**Examples**
+
+```sh
+# Install default features (no TUI)
+unclaude install
+
+# Install only telemetry suppression, globally
+unclaude install --features stopTelemetry
+
+# Uninstall LSP for Claude Code only
+unclaude uninstall --features lsp --agents claudeCode
+```
+
+## Development
+
+```sh
+npm install
+npm run dev      # run (tsx, no build step)
+npm run build    # compile → dist/
+npm publish      # builds automatically via prepublishOnly
+```
+
+Requires Node ≥ 18 and tsx (`npm install` handles dev dependencies).

package/dist/cli.js

@@ -0,0 +1,101 @@
+#!/usr/bin/env node
+import { jsx as _jsx } from "react/jsx-runtime";
+import { render } from 'ink';
+import { Command } from 'commander';
+import { App } from './install.js';
+import { runInstall } from './install.js';
+import { runUninstall } from './uninstall.js';
+import { FEATURE_ORDER, DEFAULT_FEATURES, addGitignoreEntries, removeGitignoreEntries } from './common.js';
+const AGENTS = ['claudeCode', 'openCode'];
+const SCOPES = ['global', 'project'];
+const FEATURES = FEATURE_ORDER;
+function parseList(val, valid) {
+    const items = val.split(',').map(s => s.trim());
+    for (const item of items) {
+        if (!valid.includes(item)) {
+            throw new Error(`Invalid value "${item}". Valid: ${valid.join(', ')}`);
+        }
+    }
+    return new Set(items);
+}
+function buildSelection(opts) {
+    const features = opts.features
+        ? parseList(opts.features, FEATURES)
+        : new Set(DEFAULT_FEATURES);
+    return {
+        agents: opts.agents ? parseList(opts.agents, AGENTS) : new Set(AGENTS),
+        scopes: opts.scopes ? parseList(opts.scopes, SCOPES) : new Set(SCOPES),
+        features,
+        lspLanguages: features.has('lsp') ? new Set(['cpp', 'swift']) : new Set(),
+        gitSettings: new Set(['gitignore']),
+    };
+}
+function consoleUpdateStep(id, update) {
+    if (update.status) {
+        const status = update.status === 'running' ? '...' : update.status === 'done' ? ' ✓' : update.status === 'error' ? ' ✗' : '';
+        console.log(`[${id}]${status}`);
+    }
+    if (update.line) {
+        console.log(`  ${update.line}`);
+    }
+}
+const program = new Command();
+program
+    .command('install')
+    .description('non-interactive install')
+    .option('--agents <list>', `comma-separated agents (default: all) — ${AGENTS.join(', ')}`)
+    .option('--scopes <list>', `comma-separated scopes (default: all) — ${SCOPES.join(', ')}`)
+    .option('--features <list>', `comma-separated features (default: all) — ${FEATURES.join(', ')}`)
+    .option('--no-gitignore', 'skip adding generated project-scope files to .gitignore')
+    .option('--git-user <name>', 'git user.name to embed in hooks and agent md files')
+    .option('--git-email <email>', 'git user.email to embed in hooks and agent md files')
+    .option('--branch-prefix <prefix>', 'prefix for renamed claude/* branches')
+    .action((opts, cmd) => {
+    let selection;
+    try {
+        selection = buildSelection(opts);
+    }
+    catch (e) {
+        cmd.error(String(e instanceof Error ? e.message : e));
+    }
+    const personalize = !!(opts.gitUser || opts.gitEmail || opts.branchPrefix);
+    const formState = { personalize, gitUser: opts.gitUser ?? '', gitEmail: opts.gitEmail ?? '', branchPrefix: opts.branchPrefix ?? '' };
+    runInstall(selection, formState, consoleUpdateStep)
+        .then(() => {
+        if (opts.gitignore)
+            addGitignoreEntries(selection.features);
+        console.log('Install complete.');
+        process.exit(0);
+    })
+        .catch((e) => { console.error(e); process.exit(1); });
+});
+program
+    .command('uninstall')
+    .description('non-interactive uninstall')
+    .option('--agents <list>', `comma-separated agents (default: all) — ${AGENTS.join(', ')}`)
+    .option('--scopes <list>', `comma-separated scopes (default: all) — ${SCOPES.join(', ')}`)
+    .option('--features <list>', `comma-separated features (default: all) — ${FEATURES.join(', ')}`)
+    .option('--no-gitignore', 'skip removing generated project-scope files from .gitignore')
+    .action((opts, cmd) => {
+    let selection;
+    try {
+        selection = buildSelection(opts);
+    }
+    catch (e) {
+        cmd.error(String(e instanceof Error ? e.message : e));
+    }
+    runUninstall(selection, consoleUpdateStep)
+        .then(() => {
+        if (opts.gitignore)
+            removeGitignoreEntries();
+        console.log('Uninstall complete.');
+        process.exit(0);
+    })
+        .catch((e) => { console.error(e); process.exit(1); });
+});
+if (process.argv.length <= 2) {
+    render(_jsx(App, {}));
+}
+else {
+    program.parse();
+}