pakhale 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Pratik Pakhale
+
+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,72 @@
+# pakhale
+
+My personal CLI. It keeps my coding agents — [Claude Code](https://claude.com/claude-code) and
+[opencode](https://opencode.ai) — set up the same way on every machine, from one file.
+
+```bash
+npx pakhale setup agents          # set up this machine
+npx pakhale setup agents plan     # dry run — show every change, write nothing
+```
+
+Running `plan` first is always safe: it reads the machine and prints exactly what would change.
+
+## What it sets up
+
+[`config.ts`](config.ts) is the whole source of truth. It lists the agents I use and the
+capabilities I want them to have — plugins, skills, MCP servers — plus my shared instructions
+and settings. Applying it installs whatever is missing and leaves everything else alone.
+
+Agents package things differently, so each capability says how it reaches each agent:
+
+```ts
+{
+  name: 'plannotator',
+  deliver: {
+    'claude-code': { via: 'claude-plugin', marketplace: 'plannotator', plugin: 'plannotator' },
+    opencode: { via: 'opencode-plugin', package: '@plannotator/opencode@latest' },
+  },
+}
+```
+
+| `via` | Reaches |
+| --- | --- |
+| `skills` | any agent that reads `SKILL.md` |
+| `mcp` | any agent |
+| `claude-plugin` | Claude Code |
+| `opencode-plugin` | opencode |
+
+Leaving an agent undeclared is an error rather than a silent skip, so adding a new agent tells
+me about every gap at once.
+
+## Options
+
+- `plan` or `-n, --dry-run` — show every change, write nothing
+- `-a, --agent <id>` — set up one agent (repeatable)
+- `--all` — every configured agent, no prompt
+- `--home <dir>` — apply against a different home directory
+- `-h, --help` — full usage
+
+With a terminal and no `--agent`, it asks which agents to set up — space to toggle, `a` for all.
+Piped or scripted, it applies to every configured agent without asking.
+
+## Safe by default
+
+- **Re-running changes nothing.** Every artifact is checked before it is written, installers
+  included.
+- **Settings you added yourself survive.** Keys `config.ts` does not name are preserved.
+- **A config file it cannot parse is left alone** rather than flattened.
+- **Agents you do not have installed are skipped,** never created.
+- **Anything it displaces is backed up** to `.setup-backups/<timestamp>/`.
+
+## Development
+
+```bash
+bun install
+bun src/cli.ts setup agents plan   # run from source
+bun run test                       # ~5s, no network, never touches your real ~
+bun run typecheck
+bun run build                      # dist/cli.js (Node >=20)
+```
+
+[ARCHITECTURE.md](ARCHITECTURE.md) covers how it works inside — the config vocabulary, the
+plan/diff/commit split, and how to add another agent.

package/assets/instructions/AGENTS.md

@@ -0,0 +1,29 @@
+## DO's :
+
+1. Prefer established, well-maintained libraries when they reduce overall
+complexity or improve reliability. Do not reimplement common
+functionality without a clear reason.
+
+2. Lean on the dependencies already in the project before writing your own
+implementation or adding packages. Do not assume a library lacks a
+capability without checking its documentation and types.
+
+3. Make architectural decisions for the long term. Do not accept a stopgap
+that only works for now and is meant to be replaced later.
+
+---
+
+## DONT's : 
+
+1. DO NOT COMMIT OR AUTO CREATE PR UNLESS EXPLICITLY ASKED YOU TO DO SO.
+AND IN ANY CASE NEVER EVER ADD YOURSELF AS COAUTHOR TO THE COMMITS!!
+
+Use conventional commit messages (https://www.conventionalcommits.org/):
+- Format: `type(scope): description` (scope is optional)
+- Types: feat, fix, refactor, style, docs, test, chore, perf, ci, build
+- Keep subject line under 72 chars, imperative mood, lowercase
+- Use body for details when needed, separated by blank line
+
+2. Dont use any kind of browser agent unless explicitly told you to do so. Even to test something, do not try to operate a browser.
+
+3. NEVER push changes to outward-facing/shared surfaces directly — ALWAYS show me the drafted change and wait for my explicit confirmation first. This covers PR titles/descriptions/comments, issue titles/descriptions/comments, commit messages, and anything written to GitHub, Linear, Slack, or any external service. "Update the PR description" (or similar) is a request to DRAFT it, not to apply it live. Prepare the change locally, show it to me, then apply only after I say go.

package/assets/statusline/claude-code.sh

@@ -0,0 +1,100 @@
+#!/bin/bash
+# Claude Code Status Line — minimal + info-dense
+input=$(cat)
+
+# Format integer with thousands separators (commas)
+commafy() { echo "$1" | sed -e :a -e 's/\(.*[0-9]\)\([0-9]\{3\}\)/\1,\2/;ta'; }
+
+# --- Extract fields ---
+model_full=$(echo "$input" | jq -r '.model.display_name // empty')
+# Extract only the model family (lowercase); fall back to first word of display name
+model=$(echo "$model_full" | grep -oiE 'opus|sonnet|haiku|fable|mythos' | head -1 | tr '[:upper:]' '[:lower:]')
+[ -z "$model" ] && model=$(echo "$model_full" | tr '[:upper:]' '[:lower:]' | awk '{print $1}')
+thinking=$(echo "$input" | jq -r '.thinking.enabled // false')
+effort=$(echo "$input" | jq -r '.effort.level // empty')
+cwd=$(echo "$input" | jq -r '.workspace.current_dir // .cwd // empty')
+project=$([ -n "$cwd" ] && basename "$cwd" || echo "")
+pct=$(echo "$input" | jq -r '.context_window.used_percentage // 0' | cut -d. -f1)
+ctx_size=$(echo "$input" | jq -r '.context_window.context_window_size // 0')
+tokens_k=$(echo "$input" | jq -r --argjson s "$ctx_size" --argjson p "$pct" '($s * $p / 100 / 1000) | floor')
+five_h=$(echo "$input" | jq -r '.rate_limits.five_hour.used_percentage // empty')
+seven_d=$(echo "$input" | jq -r '.rate_limits.seven_day.used_percentage // empty')
+
+
+# Git branch + diff stats
+branch=""
+diff_added=""
+diff_removed=""
+diff_files=""
+if [ -n "$cwd" ] && git -C "$cwd" rev-parse --git-dir >/dev/null 2>&1; then
+  branch=$(git -C "$cwd" symbolic-ref --short HEAD 2>/dev/null || git -C "$cwd" rev-parse --short HEAD 2>/dev/null)
+
+  # Detect base branch (run only when we have a branch name)
+  if [ -n "$branch" ]; then
+    base_ref=$(git -C "$cwd" symbolic-ref refs/remotes/origin/HEAD 2>/dev/null | sed 's|refs/remotes/||')
+    if [ -z "$base_ref" ]; then
+      for candidate in origin/release origin/main origin/master; do
+        if git -C "$cwd" rev-parse --verify "$candidate" >/dev/null 2>&1; then
+          base_ref="$candidate"
+          break
+        fi
+      done
+    fi
+
+    # Compute diff stats only when we are NOT on the base branch itself
+    if [ -n "$base_ref" ]; then
+      base_short="${base_ref#origin/}"
+      if [ "$branch" != "$base_short" ]; then
+        shortstat=$(git -C "$cwd" diff --shortstat "${base_ref}...HEAD" 2>/dev/null)
+        if [ -n "$shortstat" ]; then
+          diff_files=$(echo "$shortstat" | grep -oE '[0-9]+ file' | grep -oE '[0-9]+')
+          diff_added=$(echo "$shortstat" | grep -oE '[0-9]+ insertion' | grep -oE '[0-9]+')
+          diff_removed=$(echo "$shortstat" | grep -oE '[0-9]+ deletion' | grep -oE '[0-9]+')
+          [ -n "$diff_files" ]   && diff_files=$(commafy "$diff_files")
+          [ -n "$diff_added" ]   && diff_added=$(commafy "$diff_added")
+          [ -n "$diff_removed" ] && diff_removed=$(commafy "$diff_removed")
+        fi
+      fi
+    fi
+  fi
+fi
+
+# --- Colors ---
+RST="\033[0m"
+DIM="\033[2m"
+CYAN="\033[36m"
+BLUE="\033[34m"
+MAG="\033[35m"
+YEL="\033[33m"
+RED="\033[31m"
+GRN="\033[32m"
+
+# Percentage text color
+if [ "$pct" -lt 50 ]; then PCT_COLOR=$RST
+elif [ "$pct" -lt 85 ]; then PCT_COLOR=$YEL
+else PCT_COLOR=$RED; fi
+
+# --- Single line ---
+sep=" ${DIM}/${RST} "
+model_label="${model}"
+if [ "$thinking" = "true" ] || [ -n "$effort" ]; then
+  think_tag="think"
+  [ -n "$effort" ] && think_tag="${effort}"
+  model_label="${model} ${DIM}${think_tag}${RST}"
+fi
+out="${CYAN}${model_label}${RST}"
+[ -n "$project" ] && out="${out}${sep}${BLUE}${project}${RST}"
+[ -n "$branch" ]  && out="${out}${sep}${MAG}⎇ ${branch}${RST}"
+if [ -n "$diff_added" ] || [ -n "$diff_removed" ] || [ -n "$diff_files" ]; then
+  diff_seg=""
+  [ -n "$diff_added" ]   && diff_seg="${GRN}+${diff_added}${RST}"
+  [ -n "$diff_removed" ] && diff_seg="${diff_seg:+${diff_seg} }${RED}-${diff_removed}${RST}"
+  [ -n "$diff_files" ]   && diff_seg="${diff_seg:+${diff_seg} }${DIM}~${diff_files}f${RST}"
+  [ -n "$diff_seg" ]     && out="${out} ${diff_seg}"
+fi
+out="${out}${sep}${PCT_COLOR}${pct}%${RST} ${DIM}($(commafy "$tokens_k")k)${RST}"
+[ -n "$five_h" ] && out="${out}${sep}${DIM}5h:${RST}$(printf '%.0f' "$five_h")%"
+[ -n "$seven_d" ] && out="${out} ${DIM}7d:${RST}$(printf '%.0f' "$seven_d")%"
+
+
+printf "%b\n" "$out"