Zuletzt aktiv 1 day ago

Cross-platform Zsh setup scripts and managed dotfiles with Oh My Zsh framework, Starship prompt, aliases, functions, and path configuration.

Änderung 7ed4fc5e5b0777e86245fea7aff678840cc04710

README.md Originalformat

Bash Script Installer for Zsh

The "Bash Script Installer" simplifies the setup of Zsh.

Zsh

Ubuntu

bash -c "$(curl -fsSL https://tinyurl.com/y6fhb594)"

WSL

bash -c "$(curl -fsSL https://tinyurl.com/ycyct6wp)"

MacOS

bash -c "$(curl -fsSL https://tinyurl.com/yptybtpa)"

Configuration

bash -c "$(curl -fsSL https://tinyurl.com/y8vf753j)"

Shell framework and prompt

The installers use Oh My Zsh for framework features and plugins, with the OMZ theme disabled:

ZSH_THEME=""
source "$ZSH/oh-my-zsh.sh"
eval "$(starship init zsh)"

Starship owns the prompt and loads after Oh My Zsh. The managed Starship config is installed at ~/.config/starship.toml. A Nerd Font is required for the Powerline symbols.

AI commits

The managed aicommit function can use Claude, Copilot, or OpenCode to create a commit from staged changes:

aicommit opencode

The installers place the shared commit instructions at ~/.config/ai-commit-prompt.txt and the required OpenCode agent at ~/.config/opencode/agents/ai-commit.md. The agent is hidden from the interactive agent selector but remains available to aicommit opencode. It may inspect Git status, the cached diff, and recent history, and may execute git commit; all unrelated tools and shell commands are denied.

Changes affecting more than 30 staged paths automatically use per-module commits. They must produce multiple commits, rather than a single combined commit message. The count uses the full staged set before diff filtering or truncation, including lock/minified files and both paths of a rename. Exactly 30 paths retains the single-commit default. Pass --modules to request splitting at any size:

aicommit --modules opencode
aicommit --modules --yes claude

Automatic splitting uses the same planning and confirmation flow as --modules; --yes skips confirmation in either case (for example, aicommit --yes opencode). Plans that collapse a change above the threshold into one group are rejected before committing, with the index untouched. Grouping follows cohesive modules or submodules; 30 is the automatic-splitting threshold, not a hard size limit per planned module.

The engine first plans the split using ~/.config/ai-commit-split-prompt.txt and replies with a JSON plan that maps every staged path to a type(scope) group, ordered so dependencies land first. The function validates the plan against the staged paths, ignores paths that are not staged, appends any unplanned paths as a final commit, and shows the plan for confirmation (--yes skips it). It then stages each group from a snapshot of the original index, so partially staged files keep only their staged hunks and unstaged or untracked work is never touched, and asks the engine to commit that group with the normal commit instructions. If a group produces no commit, or a commit includes files outside its group, the run stops and restages the remaining groups. With OpenCode, planning uses the hidden ai-commit-plan agent at ~/.config/opencode/agents/ai-commit-plan.md, which is denied every tool. Python 3 is required to parse the plan.

Plan-build workflow

The local plan_build function is a thin cached launcher for the canonical public plan-build gist. When curl is available, each invocation stages plan_build.zsh, SKILL.md, and ARCHITECT.md, requires all three to be non-empty, and syntax-checks the executable. It then moves the complete bundle into a unique immutable release directory and atomically switches one current symlink. Refresh activation is serialized with a kernel-backed Zsh file lock so concurrent callers cannot mix releases and crashes cannot leave a stale lock. If refresh fails, the launcher preserves and uses the last complete, validated release and repairs its skill links. Zsh is always required; curl is required only when no valid cached release exists.

plan_build
plan_build --prompt
plan_build --writing-plan
plan_build --prompt --brainstorm
plan_build --yolo --writing-plan
plan_build --architect
plan_build --architect --new
plan_build --architect --yolo

The canonical executable defines the current command behavior and options. Each invocation binds the executable and both skills to its selected immutable release. The launcher also points the installed Claude Code skill paths through the active current release:

  • SKILL.md → ~/.claude/skills/plan-build/SKILL.md
  • ARCHITECT.md → ~/.claude/skills/plan-build-architect/SKILL.md

The launcher defaults to https://opengist.resetrix.work/weehong/plan-build/raw/HEAD and ${XDG_CACHE_HOME:-$HOME/.cache}/plan-build. Override these with PLAN_BUILD_BASE_URL and PLAN_BUILD_CACHE_DIR. Installed skill paths remain fixed at ~/.claude/skills; cached invocations receive immutable release paths through environment variables. The downloaded script is remote executable code: syntax validation catches malformed Zsh but is not a security sandbox, so only point PLAN_BUILD_BASE_URL at a source you trust. Remote code is executed in a child Zsh process and is never sourced into the caller shell.

Invoking plan_build once installs or repairs both skill links. To install standalone files without the cached launcher, follow the installation instructions in the canonical gist instead.

ai-commit-plan.md Originalformat

description: Plans how to split the staged diff supplied in the prompt into per-module commits. mode: primary hidden: true permission: "*": deny

Follow the supplied planning instructions and staged file list. Reply with only the JSON plan. Do not run commands, modify files, or change the staged set.

Changes affecting more than 30 staged paths must be modularized into at least two non-empty commits; never return a single combined group. Count the full staged file list, including lock/minified files and both paths of a rename. Split a large module into cohesive, independently reviewable submodules. At 30 paths or fewer, a single group is allowed if the changes form one module. This threshold is not a hard file limit per planned module.

ai-commit-prompt.txt Originalformat
1# Git Commit Message Generator Prompt
2
3## Role
4You are an Automated Git Commit Engine.
5
6## Objective
7Analyze staged changes (`git diff --cached`), identify the **primary logical change**, and generate a commit message that **strictly adheres** to Conventional Commits v1.0.0.
8
9---
10
11## Input
12The user will provide the output of:
13```bash
14git diff --cached
15```
16
17---
18
19## Strict Rules (Zero Tolerance)
20
21### Mandatory Module Splitting
22Changes affecting more than 30 staged paths MUST be modularized into
23multiple commits. Do not generate or execute a single combined commit for
24them. Count the full staged set, including lock/minified files omitted from
25the diff preview and both paths of a rename, not just the visible diff.
26If this input has more than 30 staged paths and is not explicitly identified
27as one module in a multi-commit plan, stop and request `aicommit --modules`.
28This refusal takes precedence over the output and execution instructions below.
29When the input says "commit X of Y, split by module" with Y greater than 1,
30generate and execute only that module's commit. The threshold applies to
31the original staged change, not a hard file limit per planned module.
32
33### 1. Header Format
34**Pattern:** `type(scope): subject`
35
36| Element | Rule |
37| :--- | :--- |
38| **Type** | ONLY use: `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `build`, `ci`, `chore` |
39| **Scope** | Optional, in parentheses, entirely lowercase (e.g., `docker`, `api`, `auth`) |
40| **Subject** | Lowercase, imperative mood ("add" not "added"), NO period at the end |
41| **Length** | Header MUST be ≤ 50 characters |
42
43### 2. Body Format
44| Element | Rule |
45| :--- | :--- |
46| **Spacing** | Exactly ONE blank line between the header and the body |
47| **Bullet Points**| Use hyphens (`-`) only |
48| **Line Length** | Each line MUST be ≤ 72 characters |
49| **Case** | Lowercase throughout |
50
51### 3. Content Rules
52* **NO** "Merge branch" or auto-generated text.
53* **NO** Markdown formatting (bold/italic/code blocks) inside the commit message string itself.
54* **NO** periods at the end of the subject line.
55* **NO** "Co-authored-by" trailers or any co-author attributions.
56
57---
58
59## Execution Steps
60
61### Step 1: Atomic Scan
62Identify the **largest cluster of related changes** (the "Primary Scope").
63
64**Priority Order for Type Selection:**
651. `ci` - Pipeline, CI/CD configuration changes
662. `feat` - New features
673. `fix` - Bug fixes
684. `refactor` - Code restructuring
695. `build` - Build system, dependencies
706. `test` - Test additions/modifications
717. `chore` - Maintenance tasks
728. `docs` - Documentation only (use ONLY if no code changes exist)
73
74### Step 2: Classify Changes
75Categorize all changed files:
76
77| Category | Influences Subject? | Include in Body? |
78| :--- | :---: | :---: |
79| **Primary Scope** | ✅ Yes | ✅ Yes |
80| **Supporting Changes** | ❌ No | ✅ Yes |
81| **Documentation** | ❌ No | ✅ Yes (as a single line) |
82
83> **Key Rule:** Documentation changes (`docs/`) should be mentioned in the body but MUST NOT influence the subject type unless documentation is the *only* change in the commit.
84
85### Step 3: Draft Commit Message
86Structure the message exactly like this:
87```text
88type(scope): subject (≤50 chars, imperative, lowercase, no period)
89
90- primary change detail 1
91- primary change detail 2
92- supporting change detail
93- add/update project documentation
94```
95
96---
97
98## Output Format & Execution Authorization
99
100You must output **ONLY** a single bash code block containing the complete git command. Do not provide any conversational filler, explanations, or greeting.
101
102Once you have generated the `git commit` bash command, **you are explicitly authorized to execute it directly in the terminal** (if your environment supports agentic execution).
103* Do not ask for further user confirmation.
104* Execute sequentially.
105* If the command fails, output the exact error message and halt execution.
106
107**Format Template:**
108```bash
109git commit -m "type(scope): subject
110
111- body detail 1
112- body detail 2
113- body detail 3"
114```
115
116---
117
118## Examples
119
120### Example 1: CI/CD with Documentation
121* **Changes:** `.gitlab-ci.yaml` (new), `Dockerfile` (new), `docs/deployment.md` (new)
122* **Output:**
123```bash
124git commit -m "ci: add gitlab pipeline and docker config
125
126- add gitlab-ci.yaml with build, test, publish stages
127- add Dockerfile for container deployment
128- add deployment documentation"
129```
130
131### Example 2: Feature with Config Changes
132* **Changes:** `src/auth/login.java` (new), `pom.xml` (modified), `docs/api.md` (new)
133* **Output:**
134```bash
135git commit -m "feat(auth): add user login endpoint
136
137- implement login service with jwt tokens
138- add spring-security dependency to pom.xml
139- add api documentation"
140```
141
142### Example 3: Documentation Only
143* **Changes:** `docs/setup.md` (new), `docs/testing.md` (modified), `README.md` (modified)
144* **Output:**
145```bash
146git commit -m "docs: add setup guide and update testing docs
147
148- add initial setup guide
149- update testing documentation with examples
150- update readme with quick start section"
151```
152
153---
154
155## Quick Reference
156
157| Type | When to Use |
158| :--- | :--- |
159| `feat` | New feature for the user |
160| `fix` | Bug fix for the user |
161| `docs` | Documentation only changes |
162| `style` | Formatting, missing semicolons, etc. (no code change) |
163| `refactor` | Code change that neither fixes a bug nor adds a feature |
164| `perf` | Code change that improves performance |
165| `test` | Adding or refactoring tests |
166| `build` | Build system or external dependencies |
167| `ci` | CI configuration files and scripts |
168| `chore` | Maintenance tasks, no production code changes |
169
ai-commit-split-prompt.txt Originalformat
1# Git Commit Split Planner Prompt
2
3## Role
4You are an Automated Git Commit Planner.
5
6## Objective
7Split the staged changes into a sequence of small, atomic commits, one per
8**module**. You only decide the grouping and order. You do NOT write commit
9messages and you do NOT run any commands.
10
11---
12
13## Input
141. The staged file list (`git diff --cached --name-status -M`)
152. A diffstat (`git diff --cached --numstat -M`: added, deleted, path)
163. The staged diff (lock files and minified files are omitted; it may be truncated)
17
18---
19
20## What Is a Module
21A module is one cohesive, independently reviewable unit of change that maps
22to a single Conventional Commit `type(scope)`. Typical modules:
23
24| Module | Example scope |
25| :--- | :--- |
26| A feature or domain area (pages, routes, services, models) | `organisation`, `auth` |
27| Shared UI components / design system | `ui` |
28| Translations / localisation | `i18n` |
29| End-to-end or integration tests not tied to one module | `e2e` |
30| Storybook stories | `storybook` |
31| Documentation | `docs` |
32| Build, dependencies, tooling config | `deps`, `eslint` |
33| CI/CD pipelines | `ci` |
34
35---
36
37## Strict Rules (Zero Tolerance)
38
391. Every path in the staged file list MUST appear in exactly one commit.
40 Copy paths exactly as listed. Never invent, rename, or omit a path.
412. A rename line (`R<score> old new`) lists two paths. Put BOTH in the same
42 commit.
433. Never split a single file across commits.
444. Lock files go in the same commit as the manifest that changed them
45 (e.g. `package.json` with `package-lock.json`).
465. Unit tests that sit next to, or only exercise, one module go in that
47 module's commit. E2E tests, storybook stories and docs get their own
48 commits unless they are the only change.
496. Each commit should have ONE type and ONE scope. If a group would need two
50 types (e.g. `feat` and `docs`), split it.
517. Do not over-split. A module normally spans several files; do not create
52 one commit per file unless each file really is its own module. Changes
53 affecting more than 30 staged paths MUST be modularized into at least two
54 non-empty commits; never return a single combined commit for them. Count
55 all staged paths, including lock/minified files and both paths of a rename.
56 Split a large module into cohesive, independently reviewable submodules.
57 At 30 paths or fewer, a single commit is allowed if all changes form one
58 module. This threshold is not a hard file limit per planned module.
598. Order commits so dependencies land first:
60 build/deps -> shared code (ui, i18n, lib, types) -> features that use
61 them -> tests -> stories/docs.
62
63---
64
65## Output Format
66
67Output ONLY one JSON object. No prose, no explanation, no markdown fences.
68
69```json
70{"commits":[{"type":"feat","scope":"i18n","files":["src/locales/en/organisation.json"]}]}
71```
72
73* `type`: one of `feat`, `fix`, `docs`, `style`, `refactor`, `perf`,
74 `test`, `build`, `ci`, `chore`
75* `scope`: lowercase scope, or an empty string if none fits
76* `files`: the exact paths from the staged file list
77
78---
79
80## Example
81
82* **Staged files:** `src/locales/en/organisation.json`,
83 `src/locales/en/settings.json`, `src/components/ui/data-table.tsx`,
84 `src/components/ui/stat-card.tsx`, `src/app/organisation/page.tsx`,
85 `src/app/organisation/list/page.tsx`,
86 `src/components/ui/data-table.stories.tsx`, `e2e/home.spec.ts`
87* **Output:**
88```json
89{"commits":[
90{"type":"feat","scope":"i18n","files":["src/locales/en/organisation.json","src/locales/en/settings.json"]},
91{"type":"feat","scope":"ui","files":["src/components/ui/data-table.tsx","src/components/ui/stat-card.tsx"]},
92{"type":"feat","scope":"organisation","files":["src/app/organisation/page.tsx","src/app/organisation/list/page.tsx"]},
93{"type":"docs","scope":"storybook","files":["src/components/ui/data-table.stories.tsx"]},
94{"type":"test","scope":"e2e","files":["e2e/home.spec.ts"]}
95]}
96```
97
ai-commit.md Originalformat

description: Creates one conventional commit from the staged diff supplied in the prompt. mode: primary hidden: true permission: "": deny bash: "": deny "git status ": allow "git diff --cached": allow "git log *": allow "git commit *": allow

Follow the supplied commit instructions and staged diff. Changes affecting more than 30 staged paths must be modularized into multiple commits; never emit or execute a single combined commit for them. Use the supplied full staged path count, or inspect git diff --cached --name-only --no-renames if it is absent, including files omitted from the diff preview. Unless the input explicitly identifies this as one module in a multi-commit plan ("commit X of Y, split by module", Y > 1), stop and request aicommit --modules when the count exceeds 30. This refusal takes precedence over commit execution.

For an eligible staged change or an individual module from that plan, generate a concise conventional commit message, then execute exactly one git commit with that message. You may inspect Git status, the cached diff, and recent log. Do not modify files or change the staged set.

alias Originalformat
1# =============================================================================
2# OS-SPECIFIC ALIASES
3# =============================================================================
4if [[ "$OSTYPE" == "linux-gnu"* ]] && command -v apt-get >/dev/null 2>&1; then
5 # Linux Only System update & cleanup
6 alias uu='sudo apt-get update && \
7 sudo apt-get upgrade -y && \
8 sudo apt-get full-upgrade -y && \
9 sudo apt-get autoremove -y && \
10 sudo apt-get autoclean -y && \
11 sudo apt-get clean'
12elif [[ "$OSTYPE" == "darwin"* ]]; then
13 # macOS Only
14 alias flushdns='sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder'
15fi
16
17# =============================================================================
18# UNIVERSAL GIT ALIASES (Fixed: Removed broken "$@" from aliases)
19# =============================================================================
20alias gph='git push'
21alias gco='git checkout'
22alias gbh='git branch'
23alias gmt='git commit'
24alias gpl='git pull'
25alias grb='git rebase'
26alias grt='git reset'
27alias gst='git status'
28alias gsts='git stash push --staged'
29# Keep staged changes in the index; the stash also records their snapshot.
30alias gstu='git stash push --keep-index --include-untracked'
31alias gsta='git stash push --include-untracked'
32alias grmrf='git checkout -- . && git clean -fd'
33
34# Create a feature worktree from origin/integration: gwa pill
35gwa() {
36 if [ "$#" -ne 1 ] || [ -z "$1" ]; then
37 printf 'Usage: gwa <feature-name>\n' >&2
38 return 1
39 fi
40 git worktree add "../worktree/$1" -b "feature/$1" origin/integration
41}
42
43# List loaded aliases, optionally filtered by a case-insensitive keyword.
44ah() {
45 if [ "$#" -eq 0 ]; then
46 alias
47 else
48 alias | command grep -iF -- "$*"
49 fi
50}
51
config.sh Originalformat
1#!/bin/bash
2set -euo pipefail
3
4# Configuration
5GIST_RAW_BASE="https://opengist.resetrix.work/weehong/f0d940c3c1214bf5b7996195199fdc09/raw/HEAD"
6CONFIG_FILES=(
7 ".alias"
8 ".func"
9 ".pathrc"
10 ".sourcerc"
11 ".vimrc"
12 ".zshrc"
13 ".config/starship.toml"
14 ".config/ai-commit-prompt.txt"
15 ".config/ai-commit-split-prompt.txt"
16 ".config/opencode/agents/ai-commit.md"
17 ".config/opencode/agents/ai-commit-plan.md"
18)
19
20echo "Starting configuration download..."
21download_failed=0
22
23for f in "${CONFIG_FILES[@]}"; do
24 # Remove the leading dot for the URL path
25 remote_name="${f#.}"
26 [[ "$f" == ".config/starship.toml" ]] && remote_name="starship.toml"
27 [[ "$f" == ".config/ai-commit-prompt.txt" ]] && remote_name="ai-commit-prompt.txt"
28 [[ "$f" == ".config/ai-commit-split-prompt.txt" ]] && remote_name="ai-commit-split-prompt.txt"
29 [[ "$f" == ".config/opencode/agents/ai-commit.md" ]] && remote_name="ai-commit.md"
30 [[ "$f" == ".config/opencode/agents/ai-commit-plan.md" ]] && remote_name="ai-commit-plan.md"
31 url="$GIST_RAW_BASE/$remote_name"
32 target="$HOME/$f"
33 tmp="${target}.tmp.$$"
34
35 echo "Downloading $f..."
36 mkdir -p "$(dirname "$target")"
37
38 # Use -f to fail silently on server errors, -s for silent, -L to follow redirects
39 if curl -fsSL "$url" -o "$tmp" && mv "$tmp" "$target"; then
40 echo "Successfully updated $target"
41 else
42 rm -f "$tmp"
43 echo "Error: Failed to download $f from $url" >&2
44 download_failed=1
45 fi
46done
47
48if [ "$download_failed" -ne 0 ]; then
49 echo "Configuration download completed with errors." >&2
50 exit 1
51fi
52
53echo "Done! All configuration files have been replaced."
54
func Originalformat
1# =============================================================================
2# CUSTOM FUNCTIONS
3# =============================================================================
4
5# -----------------------------------------------------------------------------
6# Function: funcs (List available .func functions)
7# -----------------------------------------------------------------------------
8funcs() {
9 local func_file="${1:-$HOME/.func}"
10
11 if [ ! -f "$func_file" ]; then
12 printf "Error: Function file '%s' not found.\n" "$func_file" >&2
13 return 1
14 fi
15
16 printf "Available functions in %s:\n" "$func_file"
17 awk '
18 /^# Function: / {
19 line = $0
20 sub(/^# Function: /, "", line)
21
22 name = line
23 sub(/ .*/, "", name)
24
25 desc = ""
26 if (line ~ / \(.+\)$/) {
27 desc = line
28 sub(/^[^ ]+ \(/, "", desc)
29 sub(/\)$/, "", desc)
30 }
31
32 if (desc != "") {
33 printf " %-22s %s\n", name, desc
34 } else {
35 printf " %s\n", name
36 }
37 }
38 ' "$func_file"
39}
40
41# -----------------------------------------------------------------------------
42# Function: clip (Cross-platform clipboard)
43# -----------------------------------------------------------------------------
44clip() {
45 local cmd
46 local args=()
47
48 if command -v pbcopy >/dev/null 2>&1; then
49 cmd="pbcopy" # macOS
50 elif grep -qi "microsoft" /proc/version 2>/dev/null && command -v clip.exe >/dev/null 2>&1; then
51 cmd="clip.exe" # WSL
52 elif [ "$XDG_SESSION_TYPE" = "wayland" ] && command -v wl-copy >/dev/null 2>&1; then
53 cmd="wl-copy" # Linux Wayland
54 elif command -v xclip >/dev/null 2>&1; then
55 cmd="xclip" # Linux X11 (Fallback 1)
56 args=("-selection" "clipboard")
57 elif command -v xsel >/dev/null 2>&1; then
58 cmd="xsel" # Linux X11 (Fallback 2)
59 args=("--clipboard" "--input")
60 else
61 printf "Error: No supported clipboard utility found.\n" >&2
62 return 1
63 fi
64
65 if [ $# -gt 0 ]; then
66 if [ -f "$1" ]; then
67 "$cmd" "${args[@]}" < "$1"
68 echo "Copied contents of '$1' to clipboard."
69 else
70 printf "Error: File '%s' not found.\n" "$1" >&2
71 return 1
72 fi
73 else
74 "$cmd" "${args[@]}"
75 fi
76}
77
78# -----------------------------------------------------------------------------
79# Function: open_file (Cross-platform file/directory opener)
80# -----------------------------------------------------------------------------
81open_file() {
82 local target="${1:-.}"
83
84 if [[ "$OSTYPE" == "darwin"* ]]; then
85 command open "$target"
86 elif grep -qi "microsoft" /proc/version 2>/dev/null; then
87 if command -v wslpath >/dev/null 2>&1 && command -v explorer.exe >/dev/null 2>&1; then
88 explorer.exe "$(wslpath -w "$target")"
89 else
90 printf "Error: 'wslpath' or 'explorer.exe' not found.\n" >&2
91 return 1
92 fi
93 elif [[ "$OSTYPE" == "linux-gnu"* ]]; then
94 if command -v xdg-open >/dev/null 2>&1; then
95 xdg-open "$target"
96 else
97 printf "Error: 'xdg-open' not found.\n" >&2
98 return 1
99 fi
100 fi
101}
102alias open='open_file'
103
104# -----------------------------------------------------------------------------
105# Function: ch (Supports shell, Claude, Codex, and OpenCode)
106# -----------------------------------------------------------------------------
107ch() {
108 if [ "$#" -gt 1 ]; then
109 printf "Usage: ch [--all | shell | claude | codex | opencode]\n" >&2
110 return 2
111 fi
112 case "${1:-}" in
113 --all)
114 local result=0 target
115 for target in claude codex opencode shell; do
116 ch "$target" || result=1
117 done
118
119 if [ -t 1 ]; then
120 command clear
121 fi
122 return "$result"
123 ;;
124
125 claude)
126 local claude_home="${CLAUDE_CONFIG_DIR:-$HOME/.claude}"
127 if [ -d "$claude_home/projects" ]; then
128 command rm -rf -- "$claude_home/projects"/*(DN) || return 1
129 fi
130 if [ -f "$claude_home/history.jsonl" ]; then
131 : > "$claude_home/history.jsonl" || return 1
132 fi
133 echo "Claude project history/cache cleared."
134 ;;
135
136 codex)
137 local codex_home="${CODEX_HOME:-$HOME/.codex}"
138 command mkdir -p -- "$codex_home" || return 1
139 : > "$codex_home/history.jsonl" || return 1
140
141 command rm -rf -- "$codex_home/sessions" "$codex_home/archived_sessions" "$codex_home/shell_snapshots" || return 1
142 command mkdir -p -- "$codex_home/sessions" "$codex_home/archived_sessions" "$codex_home/shell_snapshots" || return 1
143
144 echo "Codex history cleared."
145 ;;
146
147 opencode)
148 local opencode_state_home="${XDG_STATE_HOME:-$HOME/.local/state}/opencode"
149 local opencode_data_home="${XDG_DATA_HOME:-$HOME/.local/share}/opencode"
150
151 command mkdir -p -- "$opencode_state_home" "$opencode_data_home" || return 1
152 : > "$opencode_state_home/prompt-history.jsonl" || return 1
153 command rm -f -- \
154 "$opencode_data_home/opencode.db" \
155 "$opencode_data_home/opencode.db-shm" \
156 "$opencode_data_home/opencode.db-wal" || return 1
157 command rm -rf -- "$opencode_data_home/repos" "$opencode_data_home/log" "$opencode_data_home/snapshot" || return 1
158 command mkdir -p -- "$opencode_data_home/repos" "$opencode_data_home/log" "$opencode_data_home/snapshot" || return 1
159
160 echo "OpenCode history cleared."
161 ;;
162
163 ""|shell)
164 # 1. Truncate the file
165 if [ -n "${HISTFILE:-}" ]; then
166 : > "$HISTFILE" || return 1
167 fi
168
169 # 2. Start a fresh Zsh history context. HISTSIZE=0 retains one entry.
170 builtin fc -p "${HISTFILE:-}" "$HISTSIZE" "$SAVEHIST" || return 1
171
172 echo "Shell history cleared."
173 ;;
174 *)
175 printf "Usage: ch [--all | shell | claude | codex | opencode]\n" >&2
176 return 2
177 ;;
178 esac
179}
180
181# -----------------------------------------------------------------------------
182# Function: require_cli (Check external CLI availability)
183# -----------------------------------------------------------------------------
184require_cli() {
185 local binary="$1"
186 local label="$2"
187 local resolved
188
189 if command -v whence >/dev/null 2>&1; then
190 if whence -p "$binary" >/dev/null 2>&1; then
191 return 0
192 fi
193 else
194 resolved="$(command -v "$binary" 2>/dev/null)" || resolved=""
195 if [ -n "$resolved" ] && [ -x "$resolved" ]; then
196 return 0
197 fi
198 fi
199
200 printf "Error: %s ('%s') is not installed or not in your PATH.\n" "$label" "$binary" >&2
201 return 1
202}
203
204# -----------------------------------------------------------------------------
205# Function: claude (Includes --yolo and clear shortcuts)
206# -----------------------------------------------------------------------------
207claude() {
208 # Shortcut for clearing cache
209 if [[ "$1" == "clear" ]]; then
210 ch claude
211 return $?
212 fi
213
214 # Check if binary exists
215 require_cli claude "Claude Code CLI" || return 1
216
217 # Handle --yolo mode
218 if [[ "$1" == "--yolo" ]]; then
219 shift
220 command claude --dangerously-skip-permissions "$@"
221 return $?
222 fi
223
224 command claude "$@"
225}
226
227# -----------------------------------------------------------------------------
228# Internal: _prompt_confirm_indexing (Confirm project indexing via the terminal)
229# -----------------------------------------------------------------------------
230_prompt_confirm_indexing() {
231 local project_root="$1"
232 local reply
233
234 if ! (: </dev/tty) 2>/dev/null; then
235 printf "Notice: No interactive terminal available; enhancing without project indexing.\n" >&2
236 return 1
237 fi
238
239 printf "Allow Auggie to index and use project context from '%s'? (y/N) " "$project_root" >/dev/tty
240 if ! IFS= read -r reply </dev/tty; then
241 printf "\nNotice: Unable to read confirmation; enhancing without project indexing.\n" >&2
242 return 1
243 fi
244
245 case "$reply" in
246 y|Y|yes|YES|Yes)
247 return 0
248 ;;
249 *)
250 return 1
251 ;;
252 esac
253}
254
255# -----------------------------------------------------------------------------
256# Internal: _enhance_prompt (Run Auggie and write only the enhanced prompt)
257# -----------------------------------------------------------------------------
258_enhance_prompt() {
259 local prompt="$1"
260 local output_file="$2"
261 local run_dir
262 local prompt_file
263 local workspace
264 local cache_dir
265 local auth_file
266 local log_file
267 local parsed_file
268 local project_root
269 local use_project_context
270 local script_pid
271 local waited
272 local timeout_seconds
273 local monitor_status
274
275 if [ -z "$prompt" ]; then
276 printf "Error: Prompt was empty.\n" >&2
277 return 1
278 fi
279
280 if [ ! -s "$HOME/.augment/session.json" ]; then
281 printf "Error: Auggie session file not found. Run 'auggie login' first.\n" >&2
282 return 1
283 fi
284
285 run_dir="$(mktemp -d "${TMPDIR:-/tmp}/auggie-enhance.XXXXXX")" || return 1
286 prompt_file="$run_dir/prompt.txt"
287 workspace="$run_dir/workspace"
288 cache_dir="$run_dir/cache"
289 auth_file="$HOME/.augment/session.json"
290 log_file="$run_dir/auggie.log"
291 parsed_file="$run_dir/enhanced.txt"
292 mkdir -p "$workspace" "$cache_dir"
293 printf "%s\n" "$prompt" > "$prompt_file"
294
295 project_root="$(git rev-parse --show-toplevel 2>/dev/null)" || project_root="$PWD"
296 use_project_context=0
297 timeout_seconds=90
298
299 if _prompt_confirm_indexing "$project_root"; then
300 use_project_context=1
301 timeout_seconds=300
302 workspace="$project_root"
303 cache_dir="$HOME/.augment"
304 printf "Indexing approved; enhancing with project context from '%s'.\n" "$project_root" >&2
305 else
306 printf "Enhancing without project indexing.\n" >&2
307 fi
308
309 (
310 if [ "$use_project_context" -eq 1 ]; then
311 AUGGIE_PROMPT_FILE="$prompt_file" \
312 AUGGIE_WORKSPACE="$workspace" \
313 AUGGIE_CACHE_DIR="$cache_dir" \
314 AUGGIE_AUTH_FILE="$auth_file" \
315 script -q -f -O "$log_file" -c 'auggie --print --enhance-prompt --workspace-root "$AUGGIE_WORKSPACE" --augment-cache-dir "$AUGGIE_CACHE_DIR" --augment-session-json "$AUGGIE_AUTH_FILE" --allow-indexing --wait-for-indexing --dont-save-session --instruction-file "$AUGGIE_PROMPT_FILE"' </dev/null >/dev/null 2>&1 &
316 else
317 AUGGIE_PROMPT_FILE="$prompt_file" \
318 AUGGIE_WORKSPACE="$workspace" \
319 AUGGIE_CACHE_DIR="$cache_dir" \
320 AUGGIE_AUTH_FILE="$auth_file" \
321 script -q -f -O "$log_file" -c 'auggie --print --enhance-prompt --no-discover-workspaces --workspace-root "$AUGGIE_WORKSPACE" --augment-cache-dir "$AUGGIE_CACHE_DIR" --augment-session-json "$AUGGIE_AUTH_FILE" --dont-save-session --instruction-file "$AUGGIE_PROMPT_FILE"' </dev/null >/dev/null 2>&1 &
322 fi
323
324 script_pid=$!
325 waited=0
326
327 while kill -0 "$script_pid" >/dev/null 2>&1; do
328 if grep -aq "🤖" "$log_file" 2>/dev/null || grep -aq "Tool call:" "$log_file" 2>/dev/null; then
329 kill "$script_pid" >/dev/null 2>&1 || true
330 wait "$script_pid" >/dev/null 2>&1 || true
331 exit 0
332 fi
333
334 if [ "$waited" -ge "$timeout_seconds" ]; then
335 kill "$script_pid" >/dev/null 2>&1 || true
336 wait "$script_pid" >/dev/null 2>&1 || true
337 exit 124
338 fi
339
340 sleep 1
341 waited=$((waited + 1))
342 done
343
344 wait "$script_pid" >/dev/null 2>&1 || true
345 exit 0
346 )
347 monitor_status=$?
348
349 if [ "$monitor_status" -eq 124 ]; then
350 printf "Error: Timed out waiting for Auggie to enhance the prompt.\n" >&2
351 rm -rf "$run_dir"
352 return 124
353 fi
354
355 perl -ne '
356 # Auggie redraws streamed terminal lines with carriage returns. Keep only
357 # the final rendered segment so stale text cannot corrupt the prompt.
358 s/\r$//;
359 s/.*\r//;
360 1 while s/[^\x08]\x08//g;
361 s/\x08//g;
362 s/\e\][^\a]*(?:\a|\e\\)//g;
363 s/\e\[[0-?]*[ -\/]*[@-~]//g;
364 next if /Script started on/ || /Script done on/;
365 if (/^(?:✨\s*)?Enhanced prompt:\s*(.*)$/) {
366 $capturing = 1;
367 $output .= "$1\n" if length $1;
368 next;
369 }
370 next unless $capturing;
371 exit if /^🤖/ || /Tool call:/ || /Session terminated/;
372 $output .= $_;
373 END {
374 $output =~ s/^\s*\n//;
375 $output =~ s/\s+\z//;
376 print "$output\n" if length $output;
377 }
378 ' "$log_file" > "$parsed_file"
379
380 if [ ! -s "$parsed_file" ]; then
381 printf "Error: Auggie did not return an enhanced prompt.\n" >&2
382 rm -rf "$run_dir"
383 return 1
384 fi
385
386 if ! command cp "$parsed_file" "$output_file"; then
387 printf "Error: Unable to save the enhanced prompt.\n" >&2
388 rm -rf "$run_dir"
389 return 1
390 fi
391 rm -rf "$run_dir"
392}
393
394# -----------------------------------------------------------------------------
395# Function: prompt (Enhance a prompt with Auggie and optional project context)
396# -----------------------------------------------------------------------------
397prompt() {
398 local prompt
399 local line
400 local output_file
401 local input_keymap
402 local input_status
403
404 require_cli auggie "Auggie CLI" || return 1
405 require_cli script "script utility" || return 1
406
407 if [ $# -gt 0 ]; then
408 prompt="$*"
409 elif [ ! -t 0 ]; then
410 prompt="$(cat)"
411 elif [ -n "${ZSH_VERSION:-}" ]; then
412 # Keep all lines in one ZLE buffer so previous lines remain editable.
413 input_keymap="auggie-prompt-$$-$RANDOM"
414 bindkey -N "$input_keymap" emacs || return 1
415 bindkey -M "$input_keymap" '^J' self-insert
416 bindkey -M "$input_keymap" '^M' self-insert-unmeta
417 bindkey -M "$input_keymap" '^[[13;2u' accept-line
418 bindkey -M "$input_keymap" '^[[27;2;13~' accept-line
419 bindkey -M "$input_keymap" '^D' accept-line
420 printf 'Enter your prompt: Enter adds a line; Shift+Enter (configured terminal) or Ctrl+D submits; Ctrl+C cancels.\n'
421 prompt=""
422 vared -M "$input_keymap" -p '> ' prompt
423 input_status=$?
424 bindkey -D "$input_keymap"
425 [ "$input_status" -eq 0 ] || return "$input_status"
426 else
427 echo "Reading prompt... Type 'EOF' on a new line and press Enter when finished."
428 prompt=""
429
430 while IFS= read -r line; do
431 [ "$line" = "EOF" ] && break
432 if [ -z "$prompt" ]; then
433 prompt="$line"
434 else
435 prompt="${prompt}"$'\n'"${line}"
436 fi
437 done
438 fi
439
440 if [ -z "$prompt" ]; then
441 printf "Error: Prompt was empty.\n" >&2
442 return 1
443 fi
444
445 output_file="$(mktemp "${TMPDIR:-/tmp}/auggie-enhanced-prompt.XXXXXX")" || return 1
446 if ! _enhance_prompt "$prompt" "$output_file"; then
447 rm -f "$output_file"
448 return 1
449 fi
450
451 if [ -t 1 ]; then
452 clear
453 fi
454
455 printf "Enhanced prompt:\n"
456 command cat "$output_file"
457 if clip < "$output_file"; then
458 printf '\nEnhanced prompt copied to clipboard.\n' >&2
459 else
460 printf '\nUnable to copy to clipboard; the enhanced prompt is shown above.\n' >&2
461 fi
462 rm -f "$output_file"
463
464 command auggie account status
465}
466
467# -----------------------------------------------------------------------------
468# Function: plan_build (Cached canonical plan-build launcher)
469# -----------------------------------------------------------------------------
470plan_build() {
471 emulate -L zsh
472 setopt localtraps
473 local base_url="${PLAN_BUILD_BASE_URL:-https://opengist.resetrix.work/weehong/plan-build/raw/HEAD}"
474 local cache_dir="${PLAN_BUILD_CACHE_DIR:-${XDG_CACHE_HOME:-$HOME/.cache}/plan-build}"
475 local curl_command="${PLAN_BUILD_CURL_COMMAND:-curl}"
476 local skill_file="$HOME/.claude/skills/plan-build/SKILL.md"
477 local architect_file="$HOME/.claude/skills/plan-build-architect/SKILL.md"
478 local stage_dir="" release_dir="" current_tmp=""
479 local skill_tmp="" architect_tmp="" skill_backup="" architect_backup=""
480 local activation_lock="$cache_dir/.activate.lock"
481 local activation_lock_fd=""
482 local selected_release="" active_pid="" refresh_rc=1 call_rc=0 interrupted_rc=0
483
484 if ! zmodload zsh/system 2>/dev/null; then
485 printf "Error: Unable to load the Zsh system module required by plan-build.\n" >&2
486 return 1
487 fi
488
489 require_cli zsh "Zsh" || return 1
490
491 if ! command mkdir -p "$cache_dir" "${skill_file:h}" "${architect_file:h}"; then
492 printf "Error: Unable to create plan-build cache or skill directories.\n" >&2
493 return 1
494 fi
495
496 _plan_build_cleanup() {
497 if [[ -n "${active_pid:-}" ]] && command kill -0 "$active_pid" 2>/dev/null; then
498 command kill "$active_pid" 2>/dev/null || true
499 wait "$active_pid" 2>/dev/null || true
500 fi
501 active_pid=""
502 [[ -n "$stage_dir" && -d "$stage_dir" ]] && command rm -rf -- "$stage_dir"
503 command rm -f -- "$current_tmp" "$skill_tmp" "$architect_tmp"
504 command rm -f -- "$skill_backup" "$architect_backup"
505 if [[ -n "${activation_lock_fd:-}" ]]; then
506 zsystem flock -u "$activation_lock_fd" 2>/dev/null || true
507 activation_lock_fd=""
508 fi
509 }
510 _plan_build_cancel() {
511 interrupted_rc="$1"
512 [[ -n "${active_pid:-}" ]] && command kill "$active_pid" 2>/dev/null || true
513 }
514 trap '_plan_build_cleanup' EXIT
515 trap '_plan_build_cancel 129' HUP
516 trap '_plan_build_cancel 130' INT
517 trap '_plan_build_cancel 143' TERM
518
519 _plan_build_validate_release() {
520 local candidate="$1"
521 [[ -d "$candidate" &&
522 -s "$candidate/plan_build.zsh" &&
523 -s "$candidate/SKILL.md" &&
524 -s "$candidate/ARCHITECT.md" ]] &&
525 command zsh -n "$candidate/plan_build.zsh"
526 }
527
528 _plan_build_replace_path() {
529 local replacement="$1" destination="$2"
530 if command mv -fT "$replacement" "$destination" 2>/dev/null; then
531 return 0
532 fi
533 command mv -fh "$replacement" "$destination"
534 }
535
536 _plan_build_select_current() {
537 local resolved
538 [[ -L "$cache_dir/current" ]] || return 1
539 resolved="$cache_dir/current"
540 resolved="${resolved:A}"
541 _plan_build_validate_release "$resolved" || return 1
542 selected_release="$resolved"
543 }
544
545 _plan_build_acquire_activation_lock() {
546 (( interrupted_rc )) && return 1
547 command touch "$activation_lock" || return 1
548 zsystem flock -t 10 -f activation_lock_fd "$activation_lock"
549 }
550
551 _plan_build_release_activation_lock() {
552 [[ -n "$activation_lock_fd" ]] || return 0
553 zsystem flock -u "$activation_lock_fd" || return 1
554 activation_lock_fd=""
555 }
556
557 _plan_build_download() {
558 local remote="$1" destination="$2" download_rc
559 command "$curl_command" -fsSL "$remote" -o "$destination" &
560 active_pid=$!
561 wait "$active_pid"
562 download_rc=$?
563 active_pid=""
564 (( interrupted_rc )) && return "$interrupted_rc"
565 return "$download_rc"
566 }
567
568 _plan_build_backup_path() {
569 local source="$1" backup="$2"
570 [[ -e "$source" || -L "$source" ]] || return 0
571 command rm -f -- "$backup" && command cp -RP "$source" "$backup"
572 }
573
574 _plan_build_restore_path() {
575 local destination="$1" backup="$2" had_old="$3"
576 if (( had_old )); then
577 _plan_build_replace_path "$backup" "$destination" || return 1
578 else
579 command rm -f -- "$destination"
580 fi
581 }
582
583 _plan_build_install_skill_links() {
584 local activation_ok=1
585 local skill_had_old=0 architect_had_old=0
586
587 skill_tmp="$(command mktemp "${skill_file}.link.XXXXXX")" &&
588 command rm -f "$skill_tmp" &&
589 command ln -s "$cache_dir/current/SKILL.md" "$skill_tmp" || skill_tmp=""
590 architect_tmp="$(command mktemp "${architect_file}.link.XXXXXX")" &&
591 command rm -f "$architect_tmp" &&
592 command ln -s "$cache_dir/current/ARCHITECT.md" "$architect_tmp" || architect_tmp=""
593 [[ -n "$skill_tmp" && -L "$skill_tmp" &&
594 -n "$architect_tmp" && -L "$architect_tmp" ]] || return 1
595
596 skill_backup="${skill_file}.backup.$$.$RANDOM"
597 architect_backup="${architect_file}.backup.$$.$RANDOM"
598 [[ -e "$skill_file" || -L "$skill_file" ]] && skill_had_old=1
599 [[ -e "$architect_file" || -L "$architect_file" ]] && architect_had_old=1
600 _plan_build_backup_path "$skill_file" "$skill_backup" || activation_ok=0
601 (( activation_ok )) && _plan_build_backup_path "$architect_file" "$architect_backup" || activation_ok=0
602 (( activation_ok && ! interrupted_rc )) &&
603 _plan_build_replace_path "$skill_tmp" "$skill_file" || activation_ok=0
604 (( activation_ok )) && skill_tmp=""
605 (( activation_ok && ! interrupted_rc )) &&
606 _plan_build_replace_path "$architect_tmp" "$architect_file" || activation_ok=0
607 (( activation_ok )) && architect_tmp=""
608
609 if (( activation_ok )); then
610 command rm -f -- "$skill_backup" "$architect_backup"
611 skill_backup="" architect_backup=""
612 return 0
613 fi
614
615 if ! _plan_build_restore_path "$skill_file" "$skill_backup" "$skill_had_old"; then
616 printf "Error: Unable to restore plan-build skill; backup preserved at %s.\n" "$skill_backup" >&2
617 skill_backup=""
618 fi
619 if ! _plan_build_restore_path "$architect_file" "$architect_backup" "$architect_had_old"; then
620 printf "Error: Unable to restore architect skill; backup preserved at %s.\n" "$architect_backup" >&2
621 architect_backup=""
622 fi
623 return 1
624 }
625
626 if (( $+commands[$curl_command] )) || [[ "$curl_command" == */* && -x "$curl_command" ]]; then
627 stage_dir="$(command mktemp -d "$cache_dir/.stage.XXXXXX")" || stage_dir=""
628 if [[ -n "$stage_dir" ]]; then
629 _plan_build_download "$base_url/plan_build.zsh" "$stage_dir/plan_build.zsh" &&
630 _plan_build_download "$base_url/SKILL.md" "$stage_dir/SKILL.md" &&
631 _plan_build_download "$base_url/ARCHITECT.md" "$stage_dir/ARCHITECT.md"
632 refresh_rc=$?
633 if (( interrupted_rc )); then
634 _plan_build_cleanup
635 trap - EXIT HUP INT TERM
636 return "$interrupted_rc"
637 fi
638 else
639 refresh_rc=1
640 fi
641 if (( refresh_rc == 0 )) &&
642 _plan_build_validate_release "$stage_dir"; then
643 release_dir="$(command mktemp -d "$cache_dir/release.XXXXXX")" || release_dir=""
644 if [[ -n "$release_dir" ]] &&
645 command rmdir "$release_dir" &&
646 command mv "$stage_dir" "$release_dir" &&
647 _plan_build_acquire_activation_lock; then
648 stage_dir=""
649 release_dir="${release_dir:A}"
650 current_tmp="$(command mktemp "$cache_dir/.current.XXXXXX")" &&
651 command rm -f "$current_tmp" &&
652 command ln -s "$release_dir" "$current_tmp" || current_tmp=""
653
654 if [[ -n "$current_tmp" && -L "$current_tmp" ]] &&
655 _plan_build_install_skill_links &&
656 _plan_build_replace_path "$current_tmp" "$cache_dir/current"; then
657 current_tmp=""
658 selected_release="$release_dir"
659 fi
660 _plan_build_release_activation_lock || true
661 fi
662 fi
663 fi
664
665 if (( interrupted_rc )); then
666 _plan_build_cleanup
667 trap - EXIT HUP INT TERM
668 return "$interrupted_rc"
669 fi
670
671 if [[ -z "$selected_release" ]]; then
672 if ! _plan_build_select_current; then
673 if (( ! $+commands[$curl_command] )) && [[ ! ( "$curl_command" == */* && -x "$curl_command" ) ]]; then
674 printf "Error: curl is required because no valid cached plan-build bundle is available.\n" >&2
675 else
676 printf "Error: Unable to refresh plan-build and no valid cached bundle is available.\n" >&2
677 fi
678 return 1
679 fi
680 if (( ! $+commands[$curl_command] )) && [[ ! ( "$curl_command" == */* && -x "$curl_command" ) ]]; then
681 printf "Warning: curl is unavailable; using the validated cached plan-build bundle.\n" >&2
682 else
683 printf "Warning: Unable to refresh plan-build; using the validated cached bundle.\n" >&2
684 fi
685 fi
686
687 if [[ "$(command readlink "$skill_file" 2>/dev/null)" != "$cache_dir/current/SKILL.md" ||
688 "$(command readlink "$architect_file" 2>/dev/null)" != "$cache_dir/current/ARCHITECT.md" ]]; then
689 if ! _plan_build_acquire_activation_lock || ! _plan_build_install_skill_links; then
690 _plan_build_release_activation_lock 2>/dev/null || true
691 if (( interrupted_rc )); then
692 _plan_build_cleanup
693 trap - EXIT HUP INT TERM
694 return "$interrupted_rc"
695 fi
696 printf "Error: Unable to install the plan-build skill links.\n" >&2
697 return 1
698 fi
699 _plan_build_release_activation_lock || true
700 fi
701
702 if (( interrupted_rc )); then
703 _plan_build_cleanup
704 trap - EXIT HUP INT TERM
705 return "$interrupted_rc"
706 fi
707
708 PLAN_BUILD_SKILL_PATH="$selected_release/SKILL.md" \
709 PLAN_BUILD_ARCHITECT_SKILL_PATH="$selected_release/ARCHITECT.md" \
710 command zsh "$selected_release/plan_build.zsh" "$@" &
711 active_pid=$!
712 wait "$active_pid"
713 call_rc=$?
714 active_pid=""
715 (( interrupted_rc )) && call_rc="$interrupted_rc"
716 _plan_build_cleanup
717 trap - EXIT HUP INT TERM
718 return "$call_rc"
719}
720
721# -----------------------------------------------------------------------------
722# Internal: _aicommit_usage (Print aicommit usage)
723# -----------------------------------------------------------------------------
724_aicommit_usage() {
725 printf "Usage: aicommit [--modules] [--yes] [claude | copilot | opencode]\n"
726 printf " --modules Force per-module commits (automatic above 30 staged paths)\n"
727 printf " --yes Skip the plan confirmation for per-module commits\n"
728}
729
730# -----------------------------------------------------------------------------
731# Internal: _aicommit_staged_diff (Staged diff without lock/minified files)
732# -----------------------------------------------------------------------------
733_aicommit_staged_diff() {
734 # Exclude lock files/minified files and cap at ~100k characters to prevent CLI crashes
735 git diff --cached -- . ":(exclude)*.lock" ":(exclude)*-lock.json" ":(exclude)*.min.js" | head -c 100000
736}
737
738# -----------------------------------------------------------------------------
739# Internal: _aicommit_engine (Ask an AI CLI to commit or to plan a split)
740# -----------------------------------------------------------------------------
741_aicommit_engine() {
742 local engine="$1"
743 local mode="$2"
744 local input="$3"
745 local name
746
747 case "$engine" in
748 claude) name="Claude" ;;
749 copilot) name="Copilot" ;;
750 opencode) name="OpenCode" ;;
751 esac
752
753 # Status goes to stderr so plan output on stdout stays clean JSON.
754 if [ "$mode" = "plan" ]; then
755 printf "🧩 %s is planning per-module commits...\n" "$name" >&2
756 else
757 printf "🤖 %s is analyzing staged changes...\n" "$name" >&2
758 fi
759
760 case "$engine:$mode" in
761 claude:commit)
762 printf "%s\n" "$input" \
763 | command claude --allowedTools 'Bash(git commit *)' --permission-mode dontAsk -p \
764 "Read the provided instructions and diff, then generate and execute the commit."
765 ;;
766 claude:plan)
767 printf "%s\n" "$input" \
768 | command claude --permission-mode dontAsk -p \
769 "Read the provided instructions and staged changes, then reply with only the JSON plan."
770 ;;
771 copilot:commit)
772 copilot -p "$input" -s --no-ask-user --allow-tool='shell(git:*)'
773 ;;
774 copilot:plan)
775 copilot -p "$input" -s --no-ask-user
776 ;;
777 opencode:commit)
778 printf "%s\n" "$input" | opencode run --agent ai-commit
779 ;;
780 opencode:plan)
781 printf "%s\n" "$input" | opencode run --agent ai-commit-plan
782 ;;
783 esac
784}
785
786# -----------------------------------------------------------------------------
787# Internal: _aicommit_restage (Stage HEAD plus plan groups first..last from a tree)
788# -----------------------------------------------------------------------------
789_aicommit_restage() {
790 local tree="$1"
791 local run_dir="$2"
792 local first="$3"
793 local last="$4"
794 local number
795
796 if git rev-parse -q --verify HEAD >/dev/null; then
797 git read-tree HEAD || return 1
798 else
799 git read-tree --empty || return 1
800 fi
801
802 [ "$first" -le "$last" ] || return 0
803
804 number="$first"
805 while [ "$number" -le "$last" ]; do
806 cat "$run_dir/$(printf "%03d" "$number").files"
807 number=$((number + 1))
808 done | git --literal-pathspecs restore --staged --source="$tree" --pathspec-from-file=- --pathspec-file-nul
809}
810
811# -----------------------------------------------------------------------------
812# Internal: _aicommit_plan (Validate the AI split plan into per-group files)
813# -----------------------------------------------------------------------------
814_aicommit_plan() {
815 local run_dir="$1"
816
817 python3 -c '
818import json, os, re, sys
819
820sys.stdout.reconfigure(errors="backslashreplace")
821sys.stderr.reconfigure(errors="backslashreplace")
822run_dir = sys.argv[1]
823types = {"feat", "fix", "docs", "style", "refactor", "perf", "test", "build", "ci", "chore"}
824
825with open(os.path.join(run_dir, "staged"), "rb") as fh:
826 staged = [p for p in fh.read().decode("utf-8", "surrogateescape").split("\0") if p]
827with open(os.path.join(run_dir, "plan.out"), encoding="utf-8", errors="replace") as fh:
828 raw = re.sub(r"\x1b\[[0-?]*[ -/]*[@-~]", "", fh.read())
829
830# Take the last {"commits": [...]} object in the reply, ignoring fences and prose.
831plan, decoder, pos = None, json.JSONDecoder(), raw.find("{")
832while pos != -1:
833 try:
834 obj, end = decoder.raw_decode(raw, pos)
835 except ValueError:
836 pos = raw.find("{", pos + 1)
837 continue
838 if isinstance(obj, dict) and isinstance(obj.get("commits"), list):
839 plan = obj
840 pos = raw.find("{", end)
841 else:
842 pos = raw.find("{", pos + 1)
843
844if plan is None:
845 sys.exit("❌ Error: The AI reply did not contain a JSON commit plan.")
846
847# Every staged path must land in exactly one group; anything unassigned goes last.
848staged_set, seen, groups, warnings = set(staged), set(), [], []
849for commit in plan["commits"]:
850 if not isinstance(commit, dict) or not isinstance(commit.get("files"), list):
851 continue
852 files = []
853 for path in commit["files"]:
854 if not isinstance(path, str):
855 continue
856 if path not in staged_set:
857 warnings.append("ignoring path that is not staged: " + path)
858 elif path in seen:
859 warnings.append("ignoring duplicate path: " + path)
860 else:
861 seen.add(path)
862 files.append(path)
863 if not files:
864 continue
865 kind = str(commit.get("type", "")).strip().lower()
866 scope = re.sub(r"[^a-z0-9._/-]", "", str(commit.get("scope", "")).lower())
867 label = ""
868 if kind in types:
869 label = kind + ("(" + scope + ")" if scope else "")
870 groups.append((label, files))
871
872missing = [p for p in staged if p not in seen]
873if missing:
874 warnings.append("%d staged path(s) were not planned; adding them as a final commit" % len(missing))
875 groups.append(("", missing))
876
877if len(staged) > 30 and len(groups) < 2:
878 sys.exit("❌ Error: Changes affecting more than 30 staged paths require multiple module commits.")
879
880for number, (label, files) in enumerate(groups, 1):
881 base = os.path.join(run_dir, "%03d" % number)
882 with open(base + ".files", "wb") as fh:
883 fh.write("".join(p + "\0" for p in files).encode("utf-8", "surrogateescape"))
884 with open(base + ".label", "w") as fh:
885 fh.write(label)
886with open(os.path.join(run_dir, "count"), "w") as fh:
887 fh.write(str(len(groups)))
888
889for warning in warnings:
890 print("⚠️ " + warning, file=sys.stderr)
891print("📋 Planned commits:")
892for number, (label, files) in enumerate(groups, 1):
893 print(" %d. %s (%d file%s)" % (number, label or "unplanned", len(files), "" if len(files) == 1 else "s"))
894 for path in files:
895 print(" " + path)
896' "$run_dir"
897}
898
899# -----------------------------------------------------------------------------
900# Internal: _aicommit_modules_run (Plan, confirm, and commit each module group)
901# -----------------------------------------------------------------------------
902_aicommit_modules_run() {
903 local engine="$1"
904 local assume_yes="$2"
905 local run_dir="$3"
906 local prompt_file="$HOME/.config/ai-commit-prompt.txt"
907 local split_prompt_file="$HOME/.config/ai-commit-split-prompt.txt"
908 local tree
909 local total
910 local current
911 local group
912 local label
913 local hint
914 local diff
915 local expected
916 local head_before
917 local head_after
918 local unexpected
919 local reply
920
921 if ! tree="$(git write-tree 2>/dev/null)"; then
922 printf "❌ Error: Unable to snapshot the index (unresolved conflicts?).\n" >&2
923 return 1
924 fi
925
926 git diff --cached --name-only --no-renames -z > "$run_dir/staged" || return 1
927 if [ ! -s "$run_dir/staged" ]; then
928 printf "❌ Error: Nothing staged to commit.\n" >&2
929 return 1
930 fi
931
932 _aicommit_engine "$engine" plan "$(cat "$split_prompt_file")
933
934Here are the staged files:
935$(git -c core.quotePath=false diff --cached --name-status -M)
936
937Here is the diffstat:
938$(git -c core.quotePath=false diff --cached --numstat -M)
939
940Here is the git diff:
941$(_aicommit_staged_diff)" > "$run_dir/plan.out"
942
943 if ! _aicommit_plan "$run_dir"; then
944 printf "Last lines of the AI reply:\n" >&2
945 tail -n 20 "$run_dir/plan.out" >&2
946 return 1
947 fi
948 total="$(cat "$run_dir/count")"
949
950 if [ "$assume_yes" -ne 1 ]; then
951 if ! (: </dev/tty) 2>/dev/null; then
952 printf "❌ Error: No interactive terminal to confirm the plan; rerun with --yes.\n" >&2
953 return 1
954 fi
955 printf "Create these %s commit(s)? (Y/n) " "$total" >/dev/tty
956 IFS= read -r reply </dev/tty || reply="n"
957 case "$reply" in
958 ""|y|Y|yes|YES|Yes) ;;
959 *)
960 printf "Aborted. Staged changes are untouched.\n"
961 return 1
962 ;;
963 esac
964 fi
965
966 printf "💾 Staged snapshot: %s (recover with: git read-tree %s)\n" "$tree" "$tree"
967 current=1
968 trap '_aicommit_restage "$tree" "$run_dir" "$current" "$total"; printf "\n⚠️ Interrupted. Uncommitted groups are staged again.\n" >&2; rm -rf "$run_dir"; exit 130' INT TERM
969
970 while [ "$current" -le "$total" ]; do
971 group="$run_dir/$(printf "%03d" "$current").files"
972 label="$(cat "$run_dir/$(printf "%03d" "$current").label")"
973
974 if ! _aicommit_restage "$tree" "$run_dir" "$current" "$current"; then
975 printf "❌ Error: Unable to stage commit %s/%s.\n" "$current" "$total" >&2
976 _aicommit_restage "$tree" "$run_dir" "$current" "$total"
977 return 1
978 fi
979
980 expected="$(git write-tree)"
981 head_before="$(git rev-parse -q --verify HEAD)"
982 diff="$(_aicommit_staged_diff)"
983 [ -n "$diff" ] || diff="$(git diff --cached --stat)"
984
985 hint="This is commit $current of $total, split by module."
986 if [ -n "$label" ]; then
987 hint="$hint The planned type and scope is $label; use it unless the diff clearly calls for another."
988 fi
989
990 printf "\n[%s/%s] %s\n" "$current" "$total" "${label:-unplanned}"
991 _aicommit_engine "$engine" commit "$(cat "$prompt_file")
992
993$hint
994
995Here is the git diff:
996$diff"
997
998 head_after="$(git rev-parse -q --verify HEAD)"
999 if [ -z "$head_after" ] || [ "$head_after" = "$head_before" ]; then
1000 printf "❌ Error: No commit was created for group %s/%s.\n" "$current" "$total" >&2
1001 _aicommit_restage "$tree" "$run_dir" "$current" "$total"
1002 printf "Uncommitted groups are staged again.\n" >&2
1003 return 1
1004 fi
1005
1006 # Hooks may reformat this group's files, but nothing outside it may sneak in.
1007 unexpected="$(LC_ALL=C comm -13 \
1008 <(tr '\0' '\n' < "$group" | LC_ALL=C sort) \
1009 <(git diff --name-only --no-renames -z "$expected" HEAD | tr '\0' '\n' | LC_ALL=C sort))"
1010 if [ -n "$unexpected" ]; then
1011 printf "❌ Error: Commit %s/%s included files outside its group:\n%s\n" "$current" "$total" "$unexpected" >&2
1012 _aicommit_restage "$tree" "$run_dir" "$((current + 1))" "$total"
1013 printf "Inspect it with 'git show'; undo it with 'git reset --soft HEAD~1'.\n" >&2
1014 return 1
1015 fi
1016
1017 current=$((current + 1))
1018 done
1019
1020 trap - INT TERM
1021 printf "\n✅ Created %s commit(s):\n" "$total"
1022 git --no-pager log --oneline -n "$total"
1023}
1024
1025# -----------------------------------------------------------------------------
1026# Internal: _aicommit_modules (Split staged changes into per-module commits)
1027# -----------------------------------------------------------------------------
1028_aicommit_modules() {
1029 local engine="$1"
1030 local assume_yes="$2"
1031 local top
1032 local run_dir
1033 local rc
1034
1035 if [ ! -f "$HOME/.config/ai-commit-split-prompt.txt" ]; then
1036 printf "❌ Error: Configuration file not found at ~/.config/ai-commit-split-prompt.txt\n" >&2
1037 return 1
1038 fi
1039
1040 require_cli python3 "Python 3" || return 1
1041
1042 if ! top="$(git rev-parse --show-toplevel 2>/dev/null)"; then
1043 printf "❌ Error: Not inside a git work tree.\n" >&2
1044 return 1
1045 fi
1046
1047 run_dir="$(mktemp -d "${TMPDIR:-/tmp}/aicommit.XXXXXX")" || return 1
1048
1049 # Subshell: run from the repo root and keep the traps away from the caller.
1050 (
1051 trap 'rm -rf "$run_dir"; exit 130' INT TERM
1052 cd "$top" || exit 1
1053 _aicommit_modules_run "$engine" "$assume_yes" "$run_dir"
1054 )
1055 rc=$?
1056 rm -rf "$run_dir"
1057 return "$rc"
1058}
1059
1060# -----------------------------------------------------------------------------
1061# Function: aicommit (Automated Conventional Commit Engine Wrapper)
1062# -----------------------------------------------------------------------------
1063aicommit() {
1064 local engine="claude"
1065 local modules=0
1066 local assume_yes=0
1067 local arg
1068 local diff
1069 local staged_count
1070 local prompt_file="$HOME/.config/ai-commit-prompt.txt"
1071
1072 for arg in "$@"; do
1073 case "$arg" in
1074 claude|copilot|opencode) engine="$arg" ;;
1075 --modules) modules=1 ;;
1076 -y|--yes) assume_yes=1 ;;
1077 -h|--help)
1078 _aicommit_usage
1079 return 0
1080 ;;
1081 *)
1082 printf "❌ Error: Invalid argument '%s'\n" "$arg" >&2
1083 _aicommit_usage >&2
1084 return 1
1085 ;;
1086 esac
1087 done
1088
1089 if [ ! -f "$prompt_file" ]; then
1090 printf "❌ Error: Configuration file not found at ~/.config/ai-commit-prompt.txt\n" >&2
1091 printf "Please create it and paste your system prompt inside.\n" >&2
1092 return 1
1093 fi
1094
1095 # Count the full index, including excluded previews and both sides of renames.
1096 # NUL delimiters keep whitespace/newlines in filenames from skewing the count.
1097 staged_count="$(set -o pipefail; git diff --cached --name-only --no-renames -z | tr -cd '\0' | wc -c)" || return 1
1098 if [ "$staged_count" -gt 30 ] && [ "$modules" -ne 1 ]; then
1099 printf "🧩 %s staged paths exceed 30; splitting commits by module.\n" "$staged_count" >&2
1100 fi
1101 if [ "$modules" -eq 1 ] || [ "$staged_count" -gt 30 ]; then
1102 _aicommit_modules "$engine" "$assume_yes"
1103 return
1104 fi
1105
1106 diff="$(_aicommit_staged_diff)"
1107 if [ -z "$diff" ]; then
1108 printf "❌ Error: Nothing staged to commit.\n" >&2
1109 return 1
1110 fi
1111
1112 _aicommit_engine "$engine" commit "$(cat "$prompt_file")
1113
1114Staged path count: $staged_count
1115
1116Here is the git diff:
1117$diff"
1118}
1119
1120# -----------------------------------------------------------------------------
1121# Function: create (Efficiently create file + parent dirs)
1122# -----------------------------------------------------------------------------
1123create() {
1124 if ! command -v install >/dev/null 2>&1; then
1125 printf "Error: 'install' coreutil is not available.\n" >&2
1126 return 1
1127 fi
1128
1129 if [ $# -eq 0 ]; then
1130 printf "Usage: create <file> [file ...]\n" >&2
1131 return 2
1132 fi
1133
1134 for p in "$@"; do
1135 # Expand tilde manually if shell doesn't
1136 [[ "$p" == "~/"* ]] && p="${HOME}/${p#\~/}"
1137
1138 if [ -z "$p" ] || [ "$p" = "/" ]; then
1139 printf "create: refusing to operate on '%s'\n" "$p" >&2
1140 continue
1141 fi
1142
1143 if [ -e "$p" ]; then
1144 printf "create: '%s' already exists. Skipping.\n" "$p" >&2
1145 continue
1146 fi
1147
1148 if install -D /dev/null "$p"; then
1149 echo "Created '$p'"
1150 fi
1151 done
1152}
1153
1154# -----------------------------------------------------------------------------
1155# Function: ckp (Kill or check the process using a port)
1156# -----------------------------------------------------------------------------
1157ckp() {
1158 local action="kill"
1159 local signal="TERM"
1160 local port
1161 local pids
1162 local pid
1163
1164 case "${1:-}" in
1165 -c|--check)
1166 action="check"
1167 shift
1168 ;;
1169 -k|--kill)
1170 action="kill"
1171 shift
1172 ;;
1173 -f|--force)
1174 action="kill"
1175 signal="KILL"
1176 shift
1177 ;;
1178 -h|--help|"")
1179 printf "Usage: ckp [--check|-c|--kill|-k|--force|-f] <port_number>\n" >&2
1180 return 1
1181 ;;
1182 esac
1183
1184 port="${1:-}"
1185 if [[ ! "$port" =~ ^[0-9]+$ ]] || [ "$port" -lt 1 ] || [ "$port" -gt 65535 ]; then
1186 printf "Error: port must be a number between 1 and 65535.\n" >&2
1187 printf "Usage: ckp [--check|-c|--kill|-k|--force|-f] <port_number>\n" >&2
1188 return 1
1189 fi
1190
1191 if [[ "$OSTYPE" == "darwin"* ]]; then
1192 pids="$(
1193 {
1194 lsof -nP -tiTCP:"$port" -sTCP:LISTEN 2>/dev/null
1195 lsof -nP -tiUDP:"$port" 2>/dev/null
1196 } | sort -u
1197 )"
1198
1199 if [ -z "$pids" ]; then
1200 printf "Port %s is FREE\n" "$port"
1201 return 0
1202 fi
1203
1204 printf "Port %s is in use:\n" "$port"
1205 lsof -nP -iTCP:"$port" -sTCP:LISTEN -iUDP:"$port" 2>/dev/null
1206 else
1207 local port_hex
1208 local inodes
1209
1210 port_hex="$(printf "%04X" "$port")"
1211 inodes="$(
1212 awk -v port="$port_hex" '
1213 NR > 1 {
1214 split($2, local_addr, ":")
1215 if (toupper(local_addr[length(local_addr)]) == port && ($4 == "0A" || FILENAME ~ /udp/)) {
1216 print $10
1217 }
1218 }
1219 ' /proc/net/tcp /proc/net/tcp6 /proc/net/udp /proc/net/udp6 2>/dev/null | sort -u
1220 )"
1221
1222 if [ -z "$inodes" ]; then
1223 printf "Port %s is FREE\n" "$port"
1224 return 0
1225 fi
1226
1227 pids=""
1228 pids="$(
1229 find /proc/[0-9]*/fd -maxdepth 1 -type l -printf "%p %l\n" 2>/dev/null |
1230 awk -v inodes="$inodes" '
1231 BEGIN {
1232 split(inodes, inode_list, " ")
1233 for (i in inode_list) {
1234 wanted["socket:[" inode_list[i] "]"] = 1
1235 }
1236 }
1237 $2 in wanted {
1238 split($1, path, "/")
1239 print path[3]
1240 }
1241 ' | sort -u
1242 )"
1243
1244 if [ -z "$pids" ]; then
1245 printf "Port %s is in use, but no readable process owner was found.\n" "$port" >&2
1246 return 1
1247 fi
1248
1249 printf "Port %s is in use:\n" "$port"
1250 for pid in $pids; do
1251 if [ -r "/proc/$pid/cmdline" ]; then
1252 printf " PID %-8s %s\n" "$pid" "$(tr '\0' ' ' < "/proc/$pid/cmdline")"
1253 else
1254 printf " PID %s\n" "$pid"
1255 fi
1256 done
1257 fi
1258
1259 if [ "$action" = "kill" ]; then
1260 for pid in $pids; do
1261 if kill "-$signal" "$pid" 2>/dev/null; then
1262 printf "Killed PID %s with SIG%s.\n" "$pid" "$signal"
1263 else
1264 printf "Error: failed to kill PID %s. Try with sudo or --force.\n" "$pid" >&2
1265 return 1
1266 fi
1267 done
1268 fi
1269}
1270
1271# -----------------------------------------------------------------------------
1272# Function: append_path (Adds to session PATH if exists)
1273# -----------------------------------------------------------------------------
1274append_path() {
1275 local dir="$1"
1276 if [ -d "$dir" ]; then
1277 case ":$PATH:" in
1278 *":$dir:"*) ;;
1279 *) PATH="$PATH:$dir" ;;
1280 esac
1281 elif [ "${SUPPRESS_WARNINGS:-0}" -ne 1 ]; then
1282 echo "Warning: $dir does not exist." >&2
1283 fi
1284}
1285
1286# -----------------------------------------------------------------------------
1287# Function: add_path_to_config (Fixed awk/sed injection)
1288# -----------------------------------------------------------------------------
1289add_path_to_config() {
1290 local new_path="$1"
1291 local config_file="$HOME/.bashrc"
1292 [[ "$SHELL" == *"zsh"* ]] && config_file="$HOME/.zshrc"
1293
1294 if [ -z "$new_path" ]; then
1295 printf "Usage: add_path_to_config <directory>\n" >&2
1296 return 1
1297 fi
1298
1299 new_path="${new_path/#\~/$HOME}"
1300
1301 if [ ! -d "$new_path" ]; then
1302 printf "Warning: '%s' does not exist. Add anyway? (y/N) " "$new_path"
1303 read -r REPLY
1304 [[ ! $REPLY =~ ^[Yy]$ ]] && return 1
1305 fi
1306
1307 # Check if already exists in file
1308 if grep -Fq "append_path \"$new_path\"" "$config_file"; then
1309 printf "Notice: Already in %s.\n" "$config_file"
1310 return 0
1311 fi
1312
1313 # Robust Injection: Use sed to insert before export PATH or just append
1314 if grep -q "^export PATH" "$config_file"; then
1315 sed -i.bak "/^export PATH/i append_path \"$new_path\"" "$config_file"
1316 else
1317 echo "append_path \"$new_path\"" >> "$config_file"
1318 echo "export PATH" >> "$config_file"
1319 fi
1320
1321 printf "✅ Success: Added to %s\n" "$config_file"
1322 append_path "$new_path" && export PATH
1323}
1324
pathrc Originalformat
1# =============================================================================
2# ENVIRONMENT & PATH CONFIGURATION
3# =============================================================================
4
5# 1. Source functions first
6if [[ -f "$HOME/.func" && -r "$HOME/.func" ]]; then
7 source "$HOME/.func"
8fi
9
10# 2. Define Root Variables
11export DOTNET_ROOT="$HOME/.dotnet"
12export PNPM_HOME="$HOME/.local/share/pnpm"
13
14# 3. PATH INITIALIZATION
15# -----------------------------------------------------------------------------
16append_path "$HOME/.local/bin"
17append_path "$DOTNET_ROOT"
18append_path "$DOTNET_ROOT/tools"
19append_path "$HOME/.opencode/bin"
20append_path "$HOME/Flutter/bin"
21append_path "$PNPM_HOME/bin"
22
23# macOS specific paths
24if [[ "$OSTYPE" == "darwin"* ]]; then
25 append_path "/Applications/Espanso.app/Contents/MacOS"
26fi
27
28# Finalize PATH
29export PATH
sourcerc Originalformat
1# =============================================================================
2# FILE: ~/.sourcerc
3# Description: Initializes third-party package managers and external tools.
4# =============================================================================
5
6# =============================================================================
7# GENERAL ENV
8# =============================================================================
9if [[ -f "$HOME/.local/bin/env" && -r "$HOME/.local/bin/env" ]]; then
10 source "$HOME/.local/bin/env"
11fi
12
13# =============================================================================
14# SDKMAN (Java/Kotlin/Scala Version Manager)
15# =============================================================================
16export SDKMAN_DIR="$HOME/.sdkman"
17if [[ -f "$SDKMAN_DIR/bin/sdkman-init.sh" && -r "$SDKMAN_DIR/bin/sdkman-init.sh" ]]; then
18 source "$SDKMAN_DIR/bin/sdkman-init.sh"
19fi
20
21# =============================================================================
22# NVM (Node Version Manager)
23# =============================================================================
24export NVM_DIR="$HOME/.nvm"
25if [[ -f "$NVM_DIR/nvm.sh" && -r "$NVM_DIR/nvm.sh" ]]; then
26 source "$NVM_DIR/nvm.sh"
27fi
28if [[ -f "$NVM_DIR/bash_completion" && -r "$NVM_DIR/bash_completion" ]]; then
29 source "$NVM_DIR/bash_completion"
30fi
31
32# =============================================================================
33# GOOGLE CLOUD SDK
34# =============================================================================
35if [[ -f "/opt/google-cloud-sdk/path.zsh.inc" ]]; then
36 source "/opt/google-cloud-sdk/path.zsh.inc"
37fi
38
39if [[ -f "/opt/google-cloud-sdk/completion.zsh.inc" ]]; then
40 source "/opt/google-cloud-sdk/completion.zsh.inc"
41fi
42
starship.toml Originalformat
1"$schema" = 'https://starship.rs/config-schema.json'
2
3format = """
4[](red)\
5$os\
6$username\
7[](bg:peach fg:red)\
8$directory\
9[](bg:yellow fg:peach)\
10$git_branch\
11$git_status\
12[](fg:yellow bg:green)\
13$c\
14$rust\
15$golang\
16$nodejs\
17$bun\
18$php\
19$java\
20$kotlin\
21$haskell\
22$python\
23[](fg:green bg:sapphire)\
24$conda\
25[](fg:sapphire bg:lavender)\
26$time\
27[ ](fg:lavender)\
28$cmd_duration\
29$line_break\
30$character"""
31
32palette = 'catppuccin_mocha'
33
34[os]
35disabled = false
36style = "bg:red fg:crust"
37
38[os.symbols]
39Windows = ""
40Ubuntu = "󰕈"
41SUSE = ""
42Raspbian = "󰐿"
43Mint = "󰣭"
44Macos = "󰀵"
45Manjaro = ""
46Linux = "󰌽"
47Gentoo = "󰣨"
48Fedora = "󰣛"
49Alpine = ""
50Amazon = ""
51Android = ""
52AOSC = ""
53Arch = "󰣇"
54Artix = "󰣇"
55CentOS = ""
56Debian = "󰣚"
57Redhat = "󱄛"
58RedHatEnterprise = "󱄛"
59
60[username]
61show_always = true
62style_user = "bg:red fg:crust"
63style_root = "bg:red fg:crust"
64format = '[ $user]($style)'
65
66[directory]
67style = "bg:peach fg:crust"
68format = "[ $path ]($style)"
69truncation_length = 3
70truncation_symbol = "…/"
71
72[directory.substitutions]
73"Documents" = "󰈙 "
74"Downloads" = " "
75"Music" = "󰝚 "
76"Pictures" = " "
77"Developer" = "󰲋 "
78
79[git_branch]
80symbol = ""
81style = "bg:yellow"
82format = '[[ $symbol $branch ](fg:crust bg:yellow)]($style)'
83
84[git_status]
85style = "bg:yellow"
86format = '[[($all_status$ahead_behind )](fg:crust bg:yellow)]($style)'
87
88[nodejs]
89symbol = ""
90style = "bg:green"
91format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)'
92
93[bun]
94symbol = ""
95style = "bg:green"
96format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)'
97
98[c]
99symbol = " "
100style = "bg:green"
101format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)'
102
103[rust]
104symbol = ""
105style = "bg:green"
106format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)'
107
108[golang]
109symbol = ""
110style = "bg:green"
111format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)'
112
113[php]
114symbol = ""
115style = "bg:green"
116format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)'
117
118[java]
119symbol = " "
120style = "bg:green"
121format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)'
122
123[kotlin]
124symbol = ""
125style = "bg:green"
126format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)'
127
128[haskell]
129symbol = ""
130style = "bg:green"
131format = '[[ $symbol( $version) ](fg:crust bg:green)]($style)'
132
133[python]
134symbol = ""
135style = "bg:green"
136format = '[[ $symbol( $version)(\(#$virtualenv\)) ](fg:crust bg:green)]($style)'
137
138[docker_context]
139symbol = ""
140style = "bg:sapphire"
141format = '[[ $symbol( $context) ](fg:crust bg:sapphire)]($style)'
142
143[conda]
144symbol = "  "
145style = "fg:crust bg:sapphire"
146format = '[$symbol$environment ]($style)'
147ignore_base = false
148
149[time]
150disabled = false
151time_format = "%R"
152style = "bg:lavender"
153format = '[[  $time ](fg:crust bg:lavender)]($style)'
154
155[line_break]
156disabled = false
157
158[character]
159disabled = false
160success_symbol = '[❯](bold fg:green)'
161error_symbol = '[❯](bold fg:red)'
162vimcmd_symbol = '[❮](bold fg:green)'
163vimcmd_replace_one_symbol = '[❮](bold fg:lavender)'
164vimcmd_replace_symbol = '[❮](bold fg:lavender)'
165vimcmd_visual_symbol = '[❮](bold fg:yellow)'
166
167[cmd_duration]
168show_milliseconds = true
169format = " in $duration "
170style = "bg:lavender"
171disabled = false
172show_notifications = true
173min_time_to_notify = 45000
174
175[palettes.catppuccin_mocha]
176rosewater = "#f5e0dc"
177flamingo = "#f2cdcd"
178pink = "#f5c2e7"
179mauve = "#cba6f7"
180red = "#f38ba8"
181maroon = "#eba0ac"
182peach = "#fab387"
183yellow = "#f9e2af"
184green = "#a6e3a1"
185teal = "#94e2d5"
186sky = "#89dceb"
187sapphire = "#74c7ec"
188blue = "#89b4fa"
189lavender = "#b4befe"
190text = "#cdd6f4"
191subtext1 = "#bac2de"
192subtext0 = "#a6adc8"
193overlay2 = "#9399b2"
194overlay1 = "#7f849c"
195overlay0 = "#6c7086"
196surface2 = "#585b70"
197surface1 = "#45475a"
198surface0 = "#313244"
199base = "#1e1e2e"
200mantle = "#181825"
201crust = "#11111b"
202
203[palettes.catppuccin_frappe]
204rosewater = "#f2d5cf"
205flamingo = "#eebebe"
206pink = "#f4b8e4"
207mauve = "#ca9ee6"
208red = "#e78284"
209maroon = "#ea999c"
210peach = "#ef9f76"
211yellow = "#e5c890"
212green = "#a6d189"
213teal = "#81c8be"
214sky = "#99d1db"
215sapphire = "#85c1dc"
216blue = "#8caaee"
217lavender = "#babbf1"
218text = "#c6d0f5"
219subtext1 = "#b5bfe2"
220subtext0 = "#a5adce"
221overlay2 = "#949cbb"
222overlay1 = "#838ba7"
223overlay0 = "#737994"
224surface2 = "#626880"
225surface1 = "#51576d"
226surface0 = "#414559"
227base = "#303446"
228mantle = "#292c3c"
229crust = "#232634"
230
231[palettes.catppuccin_latte]
232rosewater = "#dc8a78"
233flamingo = "#dd7878"
234pink = "#ea76cb"
235mauve = "#8839ef"
236red = "#d20f39"
237maroon = "#e64553"
238peach = "#fe640b"
239yellow = "#df8e1d"
240green = "#40a02b"
241teal = "#179299"
242sky = "#04a5e5"
243sapphire = "#209fb5"
244blue = "#1e66f5"
245lavender = "#7287fd"
246text = "#4c4f69"
247subtext1 = "#5c5f77"
248subtext0 = "#6c6f85"
249overlay2 = "#7c7f93"
250overlay1 = "#8c8fa1"
251overlay0 = "#9ca0b0"
252surface2 = "#acb0be"
253surface1 = "#bcc0cc"
254surface0 = "#ccd0da"
255base = "#eff1f5"
256mantle = "#e6e9ef"
257crust = "#dce0e8"
258
259[palettes.catppuccin_macchiato]
260rosewater = "#f4dbd6"
261flamingo = "#f0c6c6"
262pink = "#f5bde6"
263mauve = "#c6a0f6"
264red = "#ed8796"
265maroon = "#ee99a0"
266peach = "#f5a97f"
267yellow = "#eed49f"
268green = "#a6da95"
269teal = "#8bd5ca"
270sky = "#91d7e3"
271sapphire = "#7dc4e4"
272blue = "#8aadf4"
273lavender = "#b7bdf8"
274text = "#cad3f5"
275subtext1 = "#b8c0e0"
276subtext0 = "#a5adcb"
277overlay2 = "#939ab7"
278overlay1 = "#8087a2"
279overlay0 = "#6e738d"
280surface2 = "#5b6078"
281surface1 = "#494d64"
282surface0 = "#363a4f"
283base = "#24273a"
284mantle = "#1e2030"
285crust = "#181926"
286
test_aicommit.py Originalformat
1#!/usr/bin/env python3
2"""Exercise aicommit routing and plan validation without invoking an AI CLI."""
3
4import json
5import os
6from pathlib import Path
7import subprocess
8import tempfile
9import unittest
10
11
12SOURCE = Path(__file__).resolve().parent / "func"
13ROUTE = '''
14source "$1"
15shift
16_aicommit_engine() { printf 'ENGINE %s %s\n' "$1" "$2"; }
17_aicommit_modules() { printf 'MODULES %s %s\n' "$1" "$2"; return 7; }
18aicommit "$@"
19'''
20
21
22class AicommitTests(unittest.TestCase):
23 def setUp(self):
24 self.temp = tempfile.TemporaryDirectory(prefix="aicommit-test-")
25 self.addCleanup(self.temp.cleanup)
26 self.root = Path(self.temp.name)
27 self.repo = self.root / "repo"
28 self.repo.mkdir()
29 self.home = self.root / "home"
30 config = self.home / ".config"
31 config.mkdir(parents=True)
32 for name in ("ai-commit-prompt.txt", "ai-commit-split-prompt.txt"):
33 (config / name).write_text((SOURCE.parent / name).read_text())
34 self.env = {**os.environ, "HOME": str(self.home)}
35 self.git("init", "-q")
36
37 def git(self, *args):
38 return subprocess.check_output(
39 ["git", *args], cwd=self.repo, env=self.env
40 )
41
42 def shell(self, script, *args, cwd=None):
43 return subprocess.run(
44 ["zsh", "-f", "-c", script, "test", str(SOURCE), *args],
45 cwd=cwd or self.repo, env=self.env, text=True, capture_output=True,
46 )
47
48 def stage(self, count, suffix=".txt"):
49 # A newline is part of one path, not an extra staged file.
50 files = [f"file {i}{suffix}" for i in range(count)]
51 if files:
52 files[0] = "line\nbreak" + suffix
53 for name in files:
54 (self.repo / name).write_text("staged content\n")
55 self.git("add", "--all")
56 return files
57
58 def test_thirty_paths_use_single_commit(self):
59 self.stage(30)
60 result = self.shell(ROUTE, "opencode")
61 self.assertEqual(result.returncode, 0, result.stderr)
62 self.assertEqual(result.stdout.strip(), "ENGINE opencode commit")
63
64 def test_thirty_one_paths_route_all_engines_and_forward_yes(self):
65 self.stage(31)
66 for engine in ("claude", "copilot", "opencode"):
67 with self.subTest(engine=engine):
68 result = self.shell(ROUTE, "--yes", engine)
69 self.assertEqual(result.returncode, 7, result.stderr)
70 self.assertEqual(result.stdout.strip(), f"MODULES {engine} 1")
71 self.assertIn("exceed 30", result.stderr)
72
73 def test_explicit_modules_below_threshold(self):
74 self.stage(1)
75 result = self.shell(ROUTE, "--modules", "copilot")
76 self.assertEqual(result.returncode, 7, result.stderr)
77 self.assertEqual(result.stdout.strip(), "MODULES copilot 0")
78
79 def test_filtered_files_still_trigger_modules_from_subdirectory(self):
80 self.stage(31, ".lock")
81 nested = self.repo / "nested"
82 nested.mkdir()
83 result = self.shell(ROUTE, cwd=nested)
84 self.assertEqual(result.returncode, 7, result.stderr)
85 self.assertEqual(result.stdout.strip(), "MODULES claude 0")
86
87 def test_empty_index_and_git_errors_never_call_engine(self):
88 for cwd in (self.repo, self.root):
89 with self.subTest(cwd=cwd):
90 result = self.shell(ROUTE, cwd=cwd)
91 self.assertNotEqual(result.returncode, 0)
92 self.assertNotIn("ENGINE", result.stdout)
93 self.assertNotIn("MODULES", result.stdout)
94
95 def plan(self, count, groups):
96 run = self.root / "plan"
97 run.mkdir()
98 files = [f"file-{i}" for i in range(count)]
99 (run / "staged").write_bytes(b"".join(p.encode() + b"\0" for p in files))
100 (run / "plan.out").write_text(json.dumps({"commits": [
101 {"type": "feat", "scope": "test", "files": group(files)}
102 for group in groups
103 ]}))
104 return self.shell('source "$1"; _aicommit_plan "$2"', str(run)), run
105
106 def test_single_group_plan_allowed_at_thirty(self):
107 result, run = self.plan(30, [lambda files: files])
108 self.assertEqual(result.returncode, 0, result.stderr)
109 self.assertEqual((run / "count").read_text(), "1")
110
111 def test_single_group_plan_rejected_above_thirty_after_deduplication(self):
112 result, run = self.plan(31, [lambda files: files, lambda files: files])
113 self.assertNotEqual(result.returncode, 0)
114 self.assertIn("require multiple module commits", result.stderr)
115 self.assertFalse((run / "count").exists())
116
117 def test_empty_plan_cannot_fall_back_to_one_large_commit(self):
118 result, _ = self.plan(31, [])
119 self.assertNotEqual(result.returncode, 0)
120 self.assertIn("require multiple module commits", result.stderr)
121
122 def test_multiple_groups_allowed_even_with_large_module(self):
123 result, run = self.plan(32, [lambda files: files[:-1], lambda files: files[-1:]])
124 self.assertEqual(result.returncode, 0, result.stderr)
125 self.assertEqual((run / "count").read_text(), "2")
126
127 def test_rejected_auto_plan_preserves_partial_index_and_worktree(self):
128 files = self.stage(31)
129 changed = self.repo / files[0]
130 changed.write_text("unstaged content\n")
131 before = self.git("write-tree")
132 plan = self.root / "single-plan.json"
133 plan.write_text(json.dumps({"commits": [{"files": files}]}))
134 result = self.shell('''
135source "$1"
136plan_file="$2"
137_aicommit_engine() {
138 if [ "$2" = plan ]; then cat "$plan_file"; else printf 'UNEXPECTED COMMIT\n'; fi
139}
140aicommit --yes opencode
141''', str(plan))
142 self.assertNotEqual(result.returncode, 0)
143 self.assertIn("require multiple module commits", result.stderr)
144 self.assertNotIn("UNEXPECTED COMMIT", result.stdout)
145 self.assertEqual(self.git("write-tree"), before)
146 self.assertEqual(changed.read_text(), "unstaged content\n")
147
148
149if __name__ == "__main__":
150 unittest.main()
151
test_plan_build.zsh Originalformat
1#!/usr/bin/env zsh
2
3set -u
4
5repo_dir="${0:A:h}"
6source "$repo_dir/func"
7
8failures=0
9fixture_dir="$(mktemp -d "${TMPDIR:-/tmp}/plan build launcher.XXXXXX")" || exit 1
10source_dir="$(mktemp -d "${TMPDIR:-/tmp}/plan-build-source.XXXXXX")" || exit 1
11export PLAN_BUILD_CACHE_DIR="$fixture_dir/cache with spaces"
12export PLAN_BUILD_BASE_URL="file://$source_dir"
13export HOME="$fixture_dir/home with spaces"
14PLAN_BUILD_SKILLS_DIR="$HOME/.claude/skills"
15mkdir -p "$source_dir" "$PLAN_BUILD_SKILLS_DIR/plan-build" "$PLAN_BUILD_SKILLS_DIR/plan-build-architect"
16print -r -- "old standard" > "$PLAN_BUILD_SKILLS_DIR/plan-build/SKILL.md"
17print -r -- "old architect" > "$PLAN_BUILD_SKILLS_DIR/plan-build-architect/SKILL.md"
18trap 'rm -rf -- "$fixture_dir" "$source_dir"' EXIT
19
20fail() {
21 print -u2 -- "FAIL: $1"
22 failures=$((failures + 1))
23}
24
25assert_equal() {
26 [[ "$1" = "$2" ]] || fail "$3 (expected '$1', got '$2')"
27}
28
29assert_contains() {
30 [[ "$1" == *"$2"* ]] || fail "$3 (missing '$2')"
31}
32
33assert_file_contains() {
34 command grep -Fq -- "$2" "$1" || fail "$3"
35}
36
37assert_bundle_consistent() {
38 local release="$PLAN_BUILD_CACHE_DIR/current"
39 local script_generation skill_generation architect_generation
40 release="${release:A}"
41 [[ -L "$PLAN_BUILD_CACHE_DIR/current" ]] || fail "$1 current is a symlink"
42 [[ -d "$release" ]] || fail "$1 current resolves to a release"
43 script_generation="$(command sed -n 's/^# generation: //p' "$release/plan_build.zsh")"
44 skill_generation="$(command sed -n 's/ standard skill$//p' "$release/SKILL.md")"
45 architect_generation="$(command sed -n 's/ architect skill$//p' "$release/ARCHITECT.md")"
46 assert_equal "$script_generation" "$skill_generation" "$1 script/standard generation"
47 assert_equal "$script_generation" "$architect_generation" "$1 script/architect generation"
48}
49
50assert_skill_links() {
51 [[ -L "$PLAN_BUILD_SKILLS_DIR/plan-build/SKILL.md" ]] || fail "$1 standard path is symlink"
52 [[ -L "$PLAN_BUILD_SKILLS_DIR/plan-build-architect/SKILL.md" ]] || fail "$1 architect path is symlink"
53 assert_equal "$PLAN_BUILD_CACHE_DIR/current/SKILL.md" \
54 "$(command readlink "$PLAN_BUILD_SKILLS_DIR/plan-build/SKILL.md")" "$1 standard link target"
55 assert_equal "$PLAN_BUILD_CACHE_DIR/current/ARCHITECT.md" \
56 "$(command readlink "$PLAN_BUILD_SKILLS_DIR/plan-build-architect/SKILL.md")" "$1 architect link target"
57}
58
59write_bundle() {
60 local generation="$1"
61 local exit_code="${2:-0}"
62 local marker_file="${3:-}"
63 print -r -- '#!/usr/bin/env zsh' > "$source_dir/plan_build.zsh"
64 print -r -- "# generation: $generation" >> "$source_dir/plan_build.zsh"
65 print -r -- "print -r -- \"$generation:\${(j:|:)@}\"" >> "$source_dir/plan_build.zsh"
66 print -r -- "print -r -- \"path:\${0}\"" >> "$source_dir/plan_build.zsh"
67 print -r -- 'print -r -- "skills:${PLAN_BUILD_SKILL_PATH}|${PLAN_BUILD_ARCHITECT_SKILL_PATH}"' >> "$source_dir/plan_build.zsh"
68 [[ -n "$marker_file" ]] && print -r -- ": > ${(q)marker_file}" >> "$source_dir/plan_build.zsh"
69 print -r -- "exit $exit_code" >> "$source_dir/plan_build.zsh"
70 print -r -- "$generation standard skill" > "$source_dir/SKILL.md"
71 print -r -- "$generation architect skill" > "$source_dir/ARCHITECT.md"
72}
73
74run_plan_build() {
75 output="$(plan_build "$@" 2>&1)"
76 rc=$?
77}
78
79write_bundle initial
80run_plan_build alpha "two words"
81assert_equal 0 "$rc" "initial migration status"
82assert_contains "$output" "initial:alpha|two words" "argument forwarding"
83assert_skill_links "initial migration"
84assert_bundle_consistent "initial migration"
85assert_file_contains "$PLAN_BUILD_SKILLS_DIR/plan-build/SKILL.md" "initial standard" "initial standard content"
86assert_file_contains "$PLAN_BUILD_SKILLS_DIR/plan-build-architect/SKILL.md" "initial architect" "initial architect content"
87execution_path="${${(f)output}[(r)path:*]#path:}"
88[[ "$execution_path" == "$PLAN_BUILD_CACHE_DIR"/release.*/plan_build.zsh ]] ||
89 fail "execution uses an immutable release path"
90assert_contains "$output" "skills:${execution_path:h}/SKILL.md|${execution_path:h}/ARCHITECT.md" \
91 "execution binds immutable skill paths"
92
93old_release="$PLAN_BUILD_CACHE_DIR/current"
94old_release="${old_release:A}"
95write_bundle replacement 23
96run_plan_build forwarded
97assert_equal 23 "$rc" "canonical status forwarding"
98assert_contains "$output" "replacement:forwarded" "replacement executes"
99new_release="$PLAN_BUILD_CACHE_DIR/current"
100new_release="${new_release:A}"
101[[ "$new_release" != "$old_release" ]] || fail "refresh activates a unique release"
102assert_skill_links "replacement"
103assert_bundle_consistent "replacement"
104
105print -r -- 'if broken' > "$source_dir/plan_build.zsh"
106print -r -- "bad standard skill" > "$source_dir/SKILL.md"
107print -r -- "bad architect skill" > "$source_dir/ARCHITECT.md"
108run_plan_build fallback
109assert_equal 23 "$rc" "failed refresh fallback status"
110assert_contains "$output" "Warning: Unable to refresh" "failed refresh warning"
111assert_contains "$output" "replacement:fallback" "failed refresh executes current"
112preserved_release="$PLAN_BUILD_CACHE_DIR/current"
113preserved_release="${preserved_release:A}"
114assert_equal "$new_release" "$preserved_release" "failed refresh preserves current"
115assert_skill_links "failed refresh"
116assert_bundle_consistent "failed refresh"
117
118export PLAN_BUILD_CURL_COMMAND="definitely-missing-plan-build-curl"
119run_plan_build no-curl
120assert_equal 23 "$rc" "missing curl fallback status"
121assert_contains "$output" "curl is unavailable" "missing curl warning"
122assert_contains "$output" "replacement:no-curl" "missing curl executes current"
123rm -f "$PLAN_BUILD_SKILLS_DIR/plan-build/SKILL.md" "$PLAN_BUILD_SKILLS_DIR/plan-build-architect/SKILL.md"
124run_plan_build repaired-offline
125assert_equal 23 "$rc" "offline skill repair status"
126assert_skill_links "offline skill repair"
127unset PLAN_BUILD_CURL_COMMAND
128
129# An already selected immutable script must not change beneath a concurrent caller.
130ready_file="$fixture_dir/ready"
131go_file="$fixture_dir/go"
132first_output="$fixture_dir/first.out"
133print -r -- '#!/usr/bin/env zsh' > "$source_dir/plan_build.zsh"
134print -r -- '# generation: concurrent_first' >> "$source_dir/plan_build.zsh"
135print -r -- 'print -r -- "concurrent_first:${(j:|:)@}"' >> "$source_dir/plan_build.zsh"
136print -r -- ": > ${(q)ready_file}" >> "$source_dir/plan_build.zsh"
137print -r -- "while [[ ! -e ${(q)go_file} ]]; do sleep 0.01; done" >> "$source_dir/plan_build.zsh"
138print -r -- 'print -r -- "finished:first"' >> "$source_dir/plan_build.zsh"
139print -r -- "concurrent_first standard skill" > "$source_dir/SKILL.md"
140print -r -- "concurrent_first architect skill" > "$source_dir/ARCHITECT.md"
141(plan_build one > "$first_output" 2>&1) &
142first_pid=$!
143for attempt in {1..500}; do
144 [[ -e "$ready_file" ]] && break
145 sleep 0.01
146done
147[[ -e "$ready_file" ]] || fail "first concurrent call reached canonical execution"
148write_bundle concurrent_second
149run_plan_build two
150assert_equal 0 "$rc" "second concurrent status"
151assert_contains "$output" "concurrent_second:two" "second concurrent generation"
152: > "$go_file"
153wait "$first_pid" || fail "first concurrent status"
154first_text="$(<"$first_output")"
155assert_contains "$first_text" "concurrent_first:one" "first call retains selected release"
156assert_contains "$first_text" "finished:first" "first immutable script finishes"
157assert_bundle_consistent "concurrent final current"
158assert_skill_links "concurrent final links"
159
160# Cancellation while refreshing must clean staging and never execute canonical code.
161blocking_curl="$fixture_dir/blocking-curl"
162cancel_started="$fixture_dir/cancel.started"
163cancel_executed="$fixture_dir/cancel.executed"
164write_bundle cancellation-marker 0 "$cancel_executed"
165run_plan_build activate-cancellation-marker
166assert_equal 0 "$rc" "cancellation marker bundle activation"
167rm -f "$cancel_executed"
168{
169 print -r -- '#!/bin/sh'
170 print -r -- "touch ${(q)cancel_started}"
171 print -r -- 'while :; do sleep 1; done'
172} > "$blocking_curl"
173chmod +x "$blocking_curl"
174export PLAN_BUILD_CURL_COMMAND="$blocking_curl"
175(plan_build cancelled > "$fixture_dir/cancel.out" 2>&1; cancel_rc=$?; print -r -- "$cancel_rc" > "$fixture_dir/cancel.rc"; exit "$cancel_rc") &
176cancel_pid=$!
177for attempt in {1..500}; do
178 [[ -e "$cancel_started" ]] && break
179 sleep 0.01
180done
181kill -TERM "$cancel_pid"
182wait "$cancel_pid"
183cancel_wait_rc=$?
184cancel_recorded_rc=""
185[[ -s "$fixture_dir/cancel.rc" ]] && cancel_recorded_rc="$(<"$fixture_dir/cancel.rc")"
186[[ "$cancel_wait_rc" = 143 || "$cancel_recorded_rc" = 143 ]] ||
187 fail "TERM returns conventional status 143"
188[[ ! -e "$cancel_executed" ]] || fail "TERM does not execute canonical plan-build"
189unset PLAN_BUILD_CURL_COMMAND
190
191# A pre-existing lock file must not be mistaken for an active kernel lock.
192print -r -- "stale contents" > "$PLAN_BUILD_CACHE_DIR/.activate.lock"
193write_bundle stale-lock-recovery
194run_plan_build recovered
195assert_equal 0 "$rc" "stale activation lock recovery status"
196assert_contains "$output" "stale-lock-recovery:recovered" "stale activation lock recovery execution"
197
198# Cancellation while canonical code runs must terminate the child promptly.
199canonical_started="$fixture_dir/canonical.started"
200canonical_finished="$fixture_dir/canonical.finished"
201print -r -- '#!/usr/bin/env zsh' > "$source_dir/plan_build.zsh"
202print -r -- '# generation: canonical-cancel' >> "$source_dir/plan_build.zsh"
203print -r -- "trap 'exit 143' TERM" >> "$source_dir/plan_build.zsh"
204print -r -- ": > ${(q)canonical_started}" >> "$source_dir/plan_build.zsh"
205print -r -- 'while :; do sleep 1; done' >> "$source_dir/plan_build.zsh"
206print -r -- ": > ${(q)canonical_finished}" >> "$source_dir/plan_build.zsh"
207print -r -- "canonical-cancel standard skill" > "$source_dir/SKILL.md"
208print -r -- "canonical-cancel architect skill" > "$source_dir/ARCHITECT.md"
209(plan_build canonical-cancel > "$fixture_dir/canonical-cancel.out" 2>&1; print -r -- "$?" > "$fixture_dir/canonical-cancel.rc") &
210canonical_pid=$!
211for attempt in {1..500}; do
212 [[ -e "$canonical_started" ]] && break
213 sleep 0.01
214done
215[[ -e "$canonical_started" ]] || fail "canonical cancellation reached execution"
216kill -TERM "$canonical_pid"
217wait "$canonical_pid"
218assert_equal 143 "$(<"$fixture_dir/canonical-cancel.rc")" "canonical cancellation status"
219[[ ! -e "$canonical_finished" ]] || fail "canonical child continued after TERM"
220
221temp_count="$(command find "$PLAN_BUILD_CACHE_DIR" -maxdepth 1 \
222 \( -name '.stage.*' -o -name '.current.*' \) -print | command wc -l | command tr -d ' ')"
223assert_equal 0 "$temp_count" "cache staging and temporary links cleaned"
224skill_temp_count="$(command find "$PLAN_BUILD_SKILLS_DIR" \
225 \( -name '*.link.*' -o -name '*.backup.*' \) -print | command wc -l | command tr -d ' ')"
226assert_equal 0 "$skill_temp_count" "skill temporary links and backups cleaned"
227
228if (( failures )); then
229 exit 1
230fi
231
232print -- "PASS: plan_build launcher tests"
233
vimrc Originalformat
1" Enable line numbers
2set number
3
4" Enable relative line numbers
5set relativenumber
6
7" Enable syntax highlighting
8syntax on
9
10" Set colorscheme
11colorscheme slate
12
13" Enable file type detection and plugins
14filetype plugin indent on
15
16" Set the tab width to 4 spaces
17set tabstop=4
18set shiftwidth=4
19set expandtab
20
21" Enable auto-indentation
22set autoindent
23set smartindent
24
25" Highlight current line
26set cursorline
27
28" Show matching parentheses
29set showmatch
30
31" Enable line wrapping
32set wrap
33
34" Enable mouse support
35set mouse=a
36
37" Use Wayland's clipboard tools when this Vim lacks native clipboard support
38if !has('clipboard') && exists('v:clipproviders')
39 \ && executable('wl-copy') && executable('wl-paste')
40 function! s:WaylandCopy(register, type, lines) abort
41 let l:text = join(a:lines, "\n")
42 if a:type ==# 'V'
43 let l:text ..= "\n"
44 endif
45 call system('wl-copy', l:text)
46 endfunction
47
48 function! s:WaylandPaste(register) abort
49 return ['', systemlist('wl-paste --no-newline')]
50 endfunction
51
52 let v:clipproviders['wltools'] = {
53 \ 'copy': {
54 \ '+': function('s:WaylandCopy'),
55 \ '*': function('s:WaylandCopy')
56 \ },
57 \ 'paste': {
58 \ '+': function('s:WaylandPaste'),
59 \ '*': function('s:WaylandPaste')
60 \ }
61 \ }
62 set clipmethod^=wltools
63endif
64set clipboard=unnamedplus
65
66" Disable swap file
67set noswapfile
68
69" Enable incremental search
70set incsearch
71
72" Ignore case in search
73set ignorecase
74
75" Override ignorecase if search contains capital letters
76set smartcase
77
78" Display line and column number of the cursor position
79set ruler
80
81" Set the status line at the bottom
82set laststatus=2
83
84" Show command in bottom bar
85set showcmd
86
87" Set command height
88set cmdheight=2
89
90" Set history lines
91set history=1000
92
93" Disable backup file
94set nobackup
95
96" Enable persistent undo
97set undofile
98
99" Set maximum number of undo levels
100set undolevels=1000
101
102" Set undo directory
103if has("persistent_undo")
104 silent !mkdir ~/.vim/undodir > /dev/null 2>&1
105 set undodir=~/.vim/undodir
106endif
107
108" Set search highlighting
109set hlsearch
110
111" Enable visual bell
112set visualbell
113
114" Set default file encoding
115set encoding=utf-8
116
117" Set the leader key to space
118let mapleader = " "
119
120" Map <Leader>w to save the file
121nnoremap <Leader>w :w<CR>
122
123" Map <Leader>q to quit
124nnoremap <Leader>q :q<CR>
125
126" Map <Leader>x to save and quit
127nnoremap <Leader>x :wq<CR>
128
129" Enable folding
130set foldmethod=syntax
131set foldlevelstart=99
132
133" Enable line wrapping at 80 characters
134set textwidth=80
135set colorcolumn=80
136
137" Add some basic key mappings
138" Map jj to escape insert mode
139inoremap jj <Esc>
140
141" Map <Leader>n to toggle line numbers
142nnoremap <Leader>n :set number!<CR>
143
144" Map <Leader>r to toggle relative line numbers
145nnoremap <Leader>r :set relativenumber!<CR>
146
147" Configure plugins (if you use a plugin manager like vim-plug)
148" Example with vim-plug:
149" call plug#begin('~/.vim/plugged')
150" Plug 'tpope/vim-sensible'
151" Plug 'preservim/nerdtree'
152" Plug 'junegunn/fzf', { 'do': { -> fzf#install() } }
153" Plug 'airblade/vim-gitgutter'
154" call plug#end()
155
156" NERDTree key mappings
157" nnoremap <C-n> :NERDTreeToggle<CR>
158
159" Enable automatic hard wrapping at textwidth (80 chars)
160set formatoptions+=t " Auto-wrap text using textwidth
161set formatoptions+=c " Auto-wrap comments using textwidth
162set formatoptions+=r " Continue comments when pressing Enter
163set formatoptions+=o " Continue comments when using 'o' or 'O'
164set formatoptions+=q " Allow formatting of comments with 'gq'
165set formatoptions+=n " Recognize numbered lists
166set formatoptions+=l " Don't break lines that were already long
167
168" Enable syntax highlighting
169syntax on
170
171" Increase memory limit for complex syntax parsing (Prevents E363)
172set maxmempattern=20000
173
zsh_macos.sh Originalformat
1#!/bin/bash
2set -euo pipefail
3
4# =============================
5# COLORS & LOGGING
6# =============================
7RED='\033[0;31m'
8GREEN='\033[0;32m'
9YELLOW='\033[1;33m'
10BLUE='\033[0;34m'
11NC='\033[0m'
12
13log() { echo -e "${BLUE}[INFO]${NC} $*"; }
14ok() { echo -e "${GREEN}[OK]${NC} $*"; }
15warn() { echo -e "${YELLOW}[WARN]${NC} $*"; }
16err() { echo -e "${RED}[ERROR]${NC} $*" >&2; }
17
18# =============================
19# CONFIG
20# =============================
21GIST_RAW_BASE="https://opengist.resetrix.work/weehong/f0d940c3c1214bf5b7996195199fdc09/raw/HEAD"
22
23CONFIG_FILES=(
24 ".alias"
25 ".func"
26 ".pathrc"
27 ".sourcerc"
28 ".vimrc"
29 ".zshrc"
30 ".config/starship.toml"
31 ".config/ai-commit-prompt.txt"
32 ".config/ai-commit-split-prompt.txt"
33 ".config/opencode/agents/ai-commit.md"
34 ".config/opencode/agents/ai-commit-plan.md"
35)
36
37# =============================
38# REQUIREMENTS
39# =============================
40check_requirements() {
41 if [[ $EUID -eq 0 ]]; then
42 err "Do not run as root on macOS"
43 exit 1
44 fi
45}
46
47# =============================
48# INSTALLATION FUNCTIONS
49# =============================
50install_oh_my_zsh() {
51 log "Installing Oh My Zsh and plugins..."
52 export RUNZSH=no
53 export CHSH=no
54 export KEEP_ZSHRC=yes
55
56 if [[ ! -d "$HOME/.oh-my-zsh" ]]; then
57 sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" --unattended
58 else
59 ok "Oh My Zsh already installed"
60 fi
61
62 local custom="${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}"
63 local plugin_dir="$custom/plugins"
64 mkdir -p "$plugin_dir"
65
66 [[ -d "$plugin_dir/zsh-autosuggestions" ]] || \
67 git clone https://github.com/zsh-users/zsh-autosuggestions "$plugin_dir/zsh-autosuggestions"
68
69 [[ -d "$plugin_dir/zsh-syntax-highlighting" ]] || \
70 git clone https://github.com/zsh-users/zsh-syntax-highlighting "$plugin_dir/zsh-syntax-highlighting"
71
72 ok "Oh My Zsh plugins installed to $plugin_dir"
73}
74
75install_starship() {
76 if command -v starship >/dev/null 2>&1 || [[ -f "$HOME/.local/bin/starship" ]]; then
77 ok "Starship already installed"
78 elif command -v brew >/dev/null 2>&1; then
79 log "Installing Starship with Homebrew..."
80 brew install starship
81 ok "Starship installed"
82 else
83 log "Installing Starship..."
84 mkdir -p "$HOME/.local/bin"
85 curl -fsSL https://starship.rs/install.sh | sh -s -- -y -b "$HOME/.local/bin"
86 ok "Starship installed"
87 fi
88}
89
90download_configs() {
91 log "Downloading custom config files..."
92 for f in "${CONFIG_FILES[@]}"; do
93 # Strip the leading dot for the download URL
94 local remote_file="${f#.}"
95 [[ "$f" == ".config/starship.toml" ]] && remote_file="starship.toml"
96 [[ "$f" == ".config/ai-commit-prompt.txt" ]] && remote_file="ai-commit-prompt.txt"
97 [[ "$f" == ".config/ai-commit-split-prompt.txt" ]] && remote_file="ai-commit-split-prompt.txt"
98 [[ "$f" == ".config/opencode/agents/ai-commit.md" ]] && remote_file="ai-commit.md"
99 [[ "$f" == ".config/opencode/agents/ai-commit-plan.md" ]] && remote_file="ai-commit-plan.md"
100 local url="$GIST_RAW_BASE/$remote_file"
101 local target="$HOME/$f"
102 local tmp="${target}.tmp.$$"
103
104 mkdir -p "$(dirname "$target")"
105
106 log "Fetching $remote_file -> $f ..."
107 if curl -fsSL "$url" -o "$tmp"; then
108 mv "$tmp" "$target"
109 else
110 rm -f "$tmp"
111 warn "Failed to download $remote_file"
112 fi
113 done
114
115 ok "Configs downloaded"
116}
117
118configure_zshrc() {
119 local zshrc="$HOME/.zshrc"
120 log "Configuring .zshrc for Oh My Zsh and Starship..."
121
122 cat > "$zshrc" <<'EOF'
123# =============================================================================
124# 1. HELPER FUNCTIONS & PATH
125# =============================================================================
126source_if_readable() {
127 local file="$1"
128 if [[ -f "$file" && -r "$file" ]]; then
129 source "$file"
130 fi
131}
132
133export PATH="$HOME/.local/bin:$PATH"
134
135# =============================================================================
136# 2. OH MY ZSH FRAMEWORK
137# =============================================================================
138export ZSH="${ZSH:-$HOME/.oh-my-zsh}"
139ZSH_THEME=""
140
141plugins=(
142 git
143 zsh-autosuggestions
144 zsh-syntax-highlighting
145)
146
147source_if_readable "$ZSH/oh-my-zsh.sh"
148
149# =============================================================================
150# 3. THIRD-PARTY INITIALIZATION & CUSTOM CONFIGS
151# =============================================================================
152source_if_readable "$HOME/.sourcerc"
153source_if_readable "$HOME/.func"
154source_if_readable "$HOME/.pathrc"
155source_if_readable "$HOME/.alias"
156
157# =============================================================================
158# 4. STARSHIP PROMPT
159# =============================================================================
160if [[ -z "${STARSHIP_CONFIG:-}" && -f "$HOME/.config/starship.toml" ]]; then
161 export STARSHIP_CONFIG="$HOME/.config/starship.toml"
162fi
163
164if command -v starship >/dev/null 2>&1; then
165 eval "$(starship init zsh)"
166elif [[ -x "$HOME/.local/bin/starship" ]]; then
167 eval "$("$HOME/.local/bin/starship" init zsh)"
168fi
169EOF
170
171 ok ".zshrc configured for Oh My Zsh framework with Starship prompt"
172}
173
174configure_git_identity() {
175 log "Configuring global Git identity..."
176 git config --global user.name "Vernon Wee Hong KOH"
177 git config --global user.email "261549452+weehong@users.noreply.github.com"
178 ok "Global Git identity configured"
179}
180
181switch_shell() {
182 log "Starting Zsh session..."
183 echo -e "${YELLOW}Type 'exit' to return to this installer menu.${NC}"
184 echo "----------------------------------------"
185 zsh -l
186 echo "----------------------------------------"
187 ok "Returned from Zsh session"
188}
189
190# =============================
191# INTERACTIVE MENU
192# =============================
193show_menu() {
194 echo "==========================================="
195 echo "macOS Minimal Zsh Setup - Choose what to do"
196 echo "==========================================="
197 echo " 0) Run ALL steps (1-6)"
198 echo " 1) Install Oh My Zsh + plugins"
199 echo " 2) Install Starship prompt"
200 echo " 3) Download custom configs (~/.alias, .func, .vimrc, etc.)"
201 echo " 4) Configure ~/.zshrc (Oh My Zsh + Starship)"
202 echo " 5) Configure global Git identity"
203 echo " 6) Switch to Zsh (Temporary Sub-shell)"
204 echo " 7) Quit"
205 echo "==========================================="
206}
207
208run_choices() {
209 local input
210 read -p "Select: " input
211 input="${input//,/ }"
212
213 local -a to_run=()
214 local -a to_exclude=()
215
216 for item in $input; do
217 if [[ "$item" == !* ]]; then
218 to_exclude+=("${item:1}")
219 elif [[ "$item" == "0" ]]; then
220 to_run+=(1 2 3 4 5 6)
221 else
222 to_run+=("$item")
223 fi
224 done
225
226 if [[ ${#to_run[@]} -gt 0 ]]; then
227 for choice in "${to_run[@]}"; do
228 local skip=false
229
230 if [[ ${#to_exclude[@]} -gt 0 ]]; then
231 for ex in "${to_exclude[@]}"; do
232 if [[ "$choice" == "$ex" ]]; then
233 skip=true
234 break
235 fi
236 done
237 fi
238
239 $skip && continue
240
241 case "$choice" in
242 1) install_oh_my_zsh ;;
243 2) install_starship ;;
244 3) download_configs ;;
245 4) configure_zshrc ;;
246 5) configure_git_identity ;;
247 6) switch_shell ;;
248 7) exit 0 ;;
249 *) warn "Skipping invalid option: $choice" ;;
250 esac
251 echo
252 done
253 fi
254}
255
256# =============================
257# MAIN
258# =============================
259main() {
260 check_requirements
261 while true; do
262 show_menu
263 run_choices
264 read -p "Do you want to run more options? (y/n): " again
265 [[ "$again" =~ ^[Yy]$ ]] || break
266 done
267 ok "macOS minimal Zsh configuration complete!"
268}
269
270main "$@"
271
zsh_ubuntu.sh Originalformat
1#!/bin/bash
2set -euo pipefail
3
4# =============================
5# COLORS & LOGGING
6# =============================
7RED='\033[0;31m'
8GREEN='\033[0;32m'
9YELLOW='\033[1;33m'
10BLUE='\033[0;34m'
11NC='\033[0m'
12
13log() { echo -e "${BLUE}[INFO]${NC} $*"; }
14ok() { echo -e "${GREEN}[OK]${NC} $*"; }
15warn() { echo -e "${YELLOW}[WARN]${NC} $*"; }
16err() { echo -e "${RED}[ERROR]${NC} $*" >&2; }
17
18# =============================
19# FLAGS & CONFIG
20# =============================
21SKIP_PACKAGES=false
22SKIP_SHELL_CHANGE=false
23INSTALL_HOMEBREW=false
24
25GIST_RAW_BASE="https://opengist.resetrix.work/weehong/f0d940c3c1214bf5b7996195199fdc09/raw/HEAD"
26CONFIG_FILES=(
27 ".alias"
28 ".func"
29 ".pathrc"
30 ".sourcerc"
31 ".vimrc"
32 ".zshrc"
33 ".config/starship.toml"
34 ".config/ai-commit-prompt.txt"
35 ".config/ai-commit-split-prompt.txt"
36 ".config/opencode/agents/ai-commit.md"
37 ".config/opencode/agents/ai-commit-plan.md"
38)
39
40# =============================
41# OS DETECTION
42# =============================
43detect_os() {
44 if [[ "$OSTYPE" == "darwin"* ]]; then
45 echo "macos"
46 elif [ -f /etc/os-release ]; then
47 . /etc/os-release
48 echo "$ID"
49 else
50 echo "unknown"
51 fi
52}
53
54# =============================
55# REQUIREMENTS
56# =============================
57check_requirements() {
58 if [[ $EUID -eq 0 ]]; then
59 err "Do not run as root. The script will request sudo when necessary."
60 exit 1
61 fi
62 if [[ "$(detect_os)" != "macos" ]] && ! command -v sudo >/dev/null 2>&1; then
63 err "sudo required on Linux"
64 exit 1
65 fi
66}
67
68# =============================
69# INSTALLATION FUNCTIONS
70# =============================
71update_system() {
72 $SKIP_PACKAGES && return
73 log "Updating system..."
74 local os=$(detect_os)
75
76 case "$os" in
77 macos)
78 brew update || warn "Homebrew update failed; continuing installer"
79 ;;
80 ubuntu|debian)
81 sudo apt-get update -y
82 if ! sudo apt-get upgrade -y; then
83 warn "System upgrade did not complete. This can happen when apt wants to downgrade a package."
84 warn "Continuing because the Zsh setup does not require OS package upgrades to finish."
85 fi
86 ;;
87 fedora)
88 sudo dnf upgrade -y || warn "System upgrade failed; continuing installer"
89 ;;
90 arch)
91 sudo pacman -Syu --noconfirm || warn "System upgrade failed; continuing installer"
92 ;;
93 *) warn "Auto-update not supported for OS: $os" ;;
94 esac
95 ok "System update step finished"
96}
97
98install_packages() {
99 $SKIP_PACKAGES && return
100 log "Installing core packages..."
101 local os=$(detect_os)
102
103 case "$os" in
104 macos) brew install zsh git vim curl wget unzip xz ;;
105 ubuntu|debian) sudo apt-get install -y zsh git vim curl wget unzip zip build-essential xz-utils ;;
106 fedora) sudo dnf install -y zsh git vim curl wget unzip zip @development-tools xz ;;
107 arch) sudo pacman -S --noconfirm zsh git vim curl wget unzip zip base-devel xz ;;
108 *) warn "Auto-install not supported for OS: $os. Please install zsh, git, vim, curl manually." ;;
109 esac
110 ok "Packages installed"
111}
112
113set_timezone() {
114 log "Setting timezone to Asia/Singapore..."
115 local os=$(detect_os)
116 if [[ "$os" == "macos" ]]; then
117 sudo systemsetup -settimezone Asia/Singapore >/dev/null
118 else
119 sudo timedatectl set-timezone Asia/Singapore
120 fi
121 ok "Timezone set to Asia/Singapore"
122}
123
124install_homebrew() {
125 ! $INSTALL_HOMEBREW && return
126 command -v brew >/dev/null 2>&1 && ok "Homebrew already installed" && return
127 log "Installing Homebrew..."
128 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
129 ok "Homebrew installed"
130}
131
132configure_shell() {
133 $SKIP_SHELL_CHANGE && return
134 log "Changing default shell to zsh..."
135 local zsh_path
136 zsh_path="$(command -v zsh)"
137
138 if ! grep -qx "$zsh_path" /etc/shells; then
139 echo "$zsh_path" | sudo tee -a /etc/shells >/dev/null
140 fi
141 chsh -s "$zsh_path"
142 ok "Shell changed (requires logout/login to take effect)"
143}
144
145install_oh_my_zsh() {
146 log "Installing Oh My Zsh and plugins..."
147 export RUNZSH=no
148 export CHSH=no
149 export KEEP_ZSHRC=yes
150
151 if [[ ! -d "$HOME/.oh-my-zsh" ]]; then
152 sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" --unattended
153 else
154 ok "Oh My Zsh already installed"
155 fi
156
157 local custom="${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}"
158 local plugin_dir="$custom/plugins"
159 mkdir -p "$plugin_dir"
160
161 [[ -d "$plugin_dir/zsh-autosuggestions" ]] || git clone https://github.com/zsh-users/zsh-autosuggestions "$plugin_dir/zsh-autosuggestions"
162 [[ -d "$plugin_dir/zsh-syntax-highlighting" ]] || git clone https://github.com/zsh-users/zsh-syntax-highlighting "$plugin_dir/zsh-syntax-highlighting"
163
164 ok "Oh My Zsh plugins installed to $plugin_dir"
165}
166
167install_starship() {
168 if command -v starship >/dev/null 2>&1 || [[ -f "$HOME/.local/bin/starship" ]]; then
169 ok "Starship already installed"
170 else
171 log "Installing Starship prompt..."
172 if command -v brew >/dev/null 2>&1; then
173 brew install starship
174 else
175 mkdir -p "$HOME/.local/bin"
176 curl -fsSL https://starship.rs/install.sh | sh -s -- -y -b "$HOME/.local/bin"
177 fi
178 ok "Starship installed"
179 fi
180}
181
182download_configs() {
183 log "Downloading custom config files from OpenGist..."
184 for f in "${CONFIG_FILES[@]}"; do
185 local remote_file="${f#.}"
186 [[ "$f" == ".config/starship.toml" ]] && remote_file="starship.toml"
187 [[ "$f" == ".config/ai-commit-prompt.txt" ]] && remote_file="ai-commit-prompt.txt"
188 [[ "$f" == ".config/ai-commit-split-prompt.txt" ]] && remote_file="ai-commit-split-prompt.txt"
189 [[ "$f" == ".config/opencode/agents/ai-commit.md" ]] && remote_file="ai-commit.md"
190 [[ "$f" == ".config/opencode/agents/ai-commit-plan.md" ]] && remote_file="ai-commit-plan.md"
191 local url="$GIST_RAW_BASE/$remote_file"
192 local target="$HOME/$f"
193 local tmp="${target}.tmp.$$"
194
195 mkdir -p "$(dirname "$target")"
196
197 log "Fetching $remote_file -> $f ..."
198 if curl -fsSL "$url" -o "$tmp"; then
199 mv "$tmp" "$target"
200 else
201 rm -f "$tmp"
202 warn "Failed to download $remote_file"
203 fi
204 done
205
206 ok "Configs downloaded"
207}
208
209configure_zshrc() {
210 local zshrc="$HOME/.zshrc"
211 log "Configuring .zshrc for Oh My Zsh and Starship..."
212
213 cat > "$zshrc" <<'EOF'
214# =============================================================================
215# 1. HELPER FUNCTIONS & PATH
216# =============================================================================
217source_if_readable() {
218 local file="$1"
219 if [[ -f "$file" && -r "$file" ]]; then
220 source "$file"
221 fi
222}
223
224export PATH="$HOME/.local/bin:$PATH"
225
226# =============================================================================
227# 2. OH MY ZSH FRAMEWORK
228# =============================================================================
229export ZSH="${ZSH:-$HOME/.oh-my-zsh}"
230ZSH_THEME=""
231
232plugins=(
233 git
234 zsh-autosuggestions
235 zsh-syntax-highlighting
236)
237
238source_if_readable "$ZSH/oh-my-zsh.sh"
239
240# =============================================================================
241# 3. THIRD-PARTY INITIALIZATION & CUSTOM CONFIGS
242# =============================================================================
243source_if_readable "$HOME/.sourcerc"
244source_if_readable "$HOME/.func"
245source_if_readable "$HOME/.pathrc"
246source_if_readable "$HOME/.alias"
247
248# =============================================================================
249# 4. STARSHIP PROMPT
250# =============================================================================
251if [[ -z "${STARSHIP_CONFIG:-}" && -f "$HOME/.config/starship.toml" ]]; then
252 export STARSHIP_CONFIG="$HOME/.config/starship.toml"
253fi
254
255if command -v starship >/dev/null 2>&1; then
256 eval "$(starship init zsh)"
257elif [[ -x "$HOME/.local/bin/starship" ]]; then
258 eval "$("$HOME/.local/bin/starship" init zsh)"
259fi
260EOF
261
262 ok ".zshrc configured for Oh My Zsh framework with Starship prompt"
263}
264
265configure_git_identity() {
266 log "Configuring global Git identity..."
267 git config --global user.name "Vernon Wee Hong KOH"
268 git config --global user.email "261549452+weehong@users.noreply.github.com"
269 ok "Global Git identity configured"
270}
271
272switch_shell() {
273 log "Starting Zsh session..."
274 echo -e "${YELLOW}Type 'exit' to return to this installer menu.${NC}"
275 echo "----------------------------------------"
276 zsh -l
277 echo "----------------------------------------"
278 ok "Returned from Zsh session"
279}
280
281# =============================
282# INTERACTIVE MENU
283# =============================
284show_menu() {
285 echo "==========================================="
286 echo "Minimal Zsh Installer - Choose what to do"
287 echo "==========================================="
288 echo " 0) Run ALL steps (1-11)"
289 echo " 1) Update system packages"
290 echo " 2) Install core packages (zsh, git, vim, etc.)"
291 echo " 3) Set Timezone (Asia/Singapore)"
292 echo " 4) Install Homebrew"
293 echo " 5) Configure shell (chsh - sets default shell)"
294 echo " 6) Install Oh My Zsh + plugins"
295 echo " 7) Install Starship prompt"
296 echo " 8) Download custom configs (from OpenGist)"
297 echo " 9) Configure ~/.zshrc (Oh My Zsh + Starship)"
298 echo "10) Configure global Git identity"
299 echo "11) Switch to Zsh (Temporary Sub-shell)"
300 echo "12) Quit"
301 echo "==========================================="
302}
303
304run_choices() {
305 local input
306 read -p "Select: " input
307 input="${input//,/ }"
308
309 local -a to_run=()
310 local -a to_exclude=()
311
312 for item in $input; do
313 if [[ "$item" == !* ]]; then
314 to_exclude+=("${item:1}")
315 elif [[ "$item" == "0" ]]; then
316 to_run+=(1 2 3 4 5 6 7 8 9 10 11)
317 else
318 to_run+=("$item")
319 fi
320 done
321
322 for choice in "${to_run[@]}"; do
323 local skip=false
324
325 for ex in "${to_exclude[@]}"; do
326 if [[ "$choice" == "$ex" ]]; then
327 skip=true
328 break
329 fi
330 done
331
332 $skip && continue
333
334 case "$choice" in
335 1) update_system ;;
336 2) install_packages ;;
337 3) set_timezone ;;
338 4) install_homebrew ;;
339 5) configure_shell ;;
340 6) install_oh_my_zsh ;;
341 7) install_starship ;;
342 8) download_configs ;;
343 9) configure_zshrc ;;
344 10) configure_git_identity ;;
345 11) switch_shell ;;
346 12) log "Exiting..."; exit 0 ;;
347 *) warn "Skipping invalid option: $choice" ;;
348 esac
349 echo
350 done
351}
352
353# =============================
354# MAIN
355# =============================
356main() {
357 check_requirements
358 while true; do
359 show_menu
360 run_choices
361 read -p "Do you want to run more options? (y/n): " again
362 [[ "$again" =~ ^[Yy]$ ]] || break
363 done
364 ok "Zsh installation/configuration complete!"
365}
366
367main "$@"
368
zsh_wsl.sh Originalformat
1#!/bin/bash
2set -euo pipefail
3
4# =============================
5# COLORS & LOGGING
6# =============================
7RED='\033[0;31m'
8GREEN='\033[0;32m'
9YELLOW='\033[1;33m'
10BLUE='\033[0;34m'
11NC='\033[0m'
12
13log() { echo -e "${BLUE}[INFO]${NC} $*"; }
14ok() { echo -e "${GREEN}[OK]${NC} $*"; }
15warn() { echo -e "${YELLOW}[WARN]${NC} $*"; }
16err() { echo -e "${RED}[ERROR]${NC} $*" >&2; }
17
18# =============================
19# FLAGS & CONFIG
20# =============================
21SKIP_PACKAGES=false
22SKIP_SHELL_CHANGE=false
23INSTALL_HOMEBREW=false
24
25GIST_RAW_BASE="https://opengist.resetrix.work/weehong/f0d940c3c1214bf5b7996195199fdc09/raw/HEAD"
26CONFIG_FILES=(
27 ".alias"
28 ".func"
29 ".pathrc"
30 ".sourcerc"
31 ".vimrc"
32 ".zshrc"
33 ".config/starship.toml"
34 ".config/ai-commit-prompt.txt"
35 ".config/ai-commit-split-prompt.txt"
36 ".config/opencode/agents/ai-commit.md"
37 ".config/opencode/agents/ai-commit-plan.md"
38)
39
40# =============================
41# PLATFORM DETECTION
42# =============================
43detect_os() {
44 if [ -f /etc/os-release ]; then
45 . /etc/os-release
46 echo "$ID"
47 else
48 echo "unknown"
49 fi
50}
51
52is_wsl() {
53 grep -qi "microsoft" /proc/version 2>/dev/null
54}
55
56# =============================
57# REQUIREMENTS
58# =============================
59check_requirements() {
60 if [[ $EUID -eq 0 ]]; then
61 err "Do not run as root. The script will request sudo when necessary."
62 exit 1
63 fi
64 if ! command -v sudo >/dev/null 2>&1; then
65 err "sudo required"
66 exit 1
67 fi
68 if ! is_wsl; then
69 err "This installer is intended for WSL"
70 exit 1
71 fi
72}
73
74# =============================
75# INSTALLATION FUNCTIONS
76# =============================
77update_system() {
78 $SKIP_PACKAGES && return
79 log "Updating system..."
80 local os=$(detect_os)
81
82 case "$os" in
83 ubuntu|debian)
84 sudo apt-get update -y
85 if ! sudo apt-get upgrade -y; then
86 warn "System upgrade did not complete. This can happen when apt wants to downgrade a package."
87 warn "Continuing because the Zsh setup does not require OS package upgrades to finish."
88 fi
89 ;;
90 fedora)
91 sudo dnf upgrade -y || warn "System upgrade failed; continuing installer"
92 ;;
93 arch)
94 sudo pacman -Syu --noconfirm || warn "System upgrade failed; continuing installer"
95 ;;
96 *) warn "Auto-update not supported for OS: $os" ;;
97 esac
98 ok "System update step finished"
99}
100
101install_packages() {
102 $SKIP_PACKAGES && return
103 log "Installing core packages..."
104 local os=$(detect_os)
105
106 case "$os" in
107 ubuntu|debian) sudo apt-get install -y zsh git vim curl wget unzip zip build-essential xz-utils ;;
108 fedora) sudo dnf install -y zsh git vim curl wget unzip zip @development-tools xz ;;
109 arch) sudo pacman -S --noconfirm zsh git vim curl wget unzip zip base-devel xz ;;
110 *) warn "Auto-install not supported for OS: $os. Please install zsh, git, vim, curl manually." ;;
111 esac
112 ok "Packages installed"
113}
114
115set_timezone() {
116 log "Checking timezone configuration..."
117 if command -v timedatectl >/dev/null 2>&1 && timedatectl status >/dev/null 2>&1; then
118 sudo timedatectl set-timezone Asia/Singapore
119 ok "Timezone set to Asia/Singapore"
120 return
121 fi
122
123 warn "Skipping timezone change: timedatectl is not available in this WSL environment"
124}
125
126install_homebrew() {
127 ! $INSTALL_HOMEBREW && return
128 command -v brew >/dev/null 2>&1 && ok "Homebrew already installed" && return
129 log "Installing Homebrew..."
130 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
131 ok "Homebrew installed"
132}
133
134configure_shell() {
135 $SKIP_SHELL_CHANGE && return
136 log "Changing default shell to zsh..."
137 local zsh_path
138 zsh_path="$(command -v zsh)"
139
140 if ! grep -qx "$zsh_path" /etc/shells; then
141 echo "$zsh_path" | sudo tee -a /etc/shells >/dev/null
142 fi
143 chsh -s "$zsh_path"
144 ok "Shell changed (open a new WSL session for it to take effect)"
145}
146
147install_oh_my_zsh() {
148 log "Installing Oh My Zsh and plugins..."
149 export RUNZSH=no
150 export CHSH=no
151 export KEEP_ZSHRC=yes
152
153 if [[ ! -d "$HOME/.oh-my-zsh" ]]; then
154 sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" --unattended
155 else
156 ok "Oh My Zsh already installed"
157 fi
158
159 local custom="${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}"
160 local plugin_dir="$custom/plugins"
161 mkdir -p "$plugin_dir"
162
163 [[ -d "$plugin_dir/zsh-autosuggestions" ]] || git clone https://github.com/zsh-users/zsh-autosuggestions "$plugin_dir/zsh-autosuggestions"
164 [[ -d "$plugin_dir/zsh-syntax-highlighting" ]] || git clone https://github.com/zsh-users/zsh-syntax-highlighting "$plugin_dir/zsh-syntax-highlighting"
165
166 ok "Oh My Zsh plugins installed to $plugin_dir"
167}
168
169install_starship() {
170 if command -v starship >/dev/null 2>&1 || [[ -f "$HOME/.local/bin/starship" ]]; then
171 ok "Starship already installed"
172 else
173 log "Installing Starship prompt..."
174 if command -v brew >/dev/null 2>&1; then
175 brew install starship
176 else
177 mkdir -p "$HOME/.local/bin"
178 curl -fsSL https://starship.rs/install.sh | sh -s -- -y -b "$HOME/.local/bin"
179 fi
180 ok "Starship installed"
181 fi
182}
183
184download_configs() {
185 log "Downloading custom config files from OpenGist..."
186 for f in "${CONFIG_FILES[@]}"; do
187 local remote_file="${f#.}"
188 [[ "$f" == ".config/starship.toml" ]] && remote_file="starship.toml"
189 [[ "$f" == ".config/ai-commit-prompt.txt" ]] && remote_file="ai-commit-prompt.txt"
190 [[ "$f" == ".config/ai-commit-split-prompt.txt" ]] && remote_file="ai-commit-split-prompt.txt"
191 [[ "$f" == ".config/opencode/agents/ai-commit.md" ]] && remote_file="ai-commit.md"
192 [[ "$f" == ".config/opencode/agents/ai-commit-plan.md" ]] && remote_file="ai-commit-plan.md"
193 local url="$GIST_RAW_BASE/$remote_file"
194 local target="$HOME/$f"
195 local tmp="${target}.tmp.$$"
196
197 mkdir -p "$(dirname "$target")"
198
199 log "Fetching $remote_file -> $f ..."
200 if curl -fsSL "$url" -o "$tmp"; then
201 mv "$tmp" "$target"
202 else
203 rm -f "$tmp"
204 warn "Failed to download $remote_file"
205 fi
206 done
207
208 ok "Configs downloaded"
209}
210
211configure_zshrc() {
212 local zshrc="$HOME/.zshrc"
213 log "Configuring .zshrc for Oh My Zsh and Starship..."
214
215 cat > "$zshrc" <<'EOF'
216# =============================================================================
217# 1. HELPER FUNCTIONS & PATH
218# =============================================================================
219source_if_readable() {
220 local file="$1"
221 if [[ -f "$file" && -r "$file" ]]; then
222 source "$file"
223 fi
224}
225
226export PATH="$HOME/.local/bin:$PATH"
227
228# =============================================================================
229# 2. OH MY ZSH FRAMEWORK
230# =============================================================================
231export ZSH="${ZSH:-$HOME/.oh-my-zsh}"
232ZSH_THEME=""
233
234plugins=(
235 git
236 zsh-autosuggestions
237 zsh-syntax-highlighting
238)
239
240source_if_readable "$ZSH/oh-my-zsh.sh"
241
242# =============================================================================
243# 3. THIRD-PARTY INITIALIZATION & CUSTOM CONFIGS
244# =============================================================================
245source_if_readable "$HOME/.sourcerc"
246source_if_readable "$HOME/.func"
247source_if_readable "$HOME/.pathrc"
248source_if_readable "$HOME/.alias"
249
250# =============================================================================
251# 4. STARSHIP PROMPT
252# =============================================================================
253if [[ -z "${STARSHIP_CONFIG:-}" && -f "$HOME/.config/starship.toml" ]]; then
254 export STARSHIP_CONFIG="$HOME/.config/starship.toml"
255fi
256
257if command -v starship >/dev/null 2>&1; then
258 eval "$(starship init zsh)"
259elif [[ -x "$HOME/.local/bin/starship" ]]; then
260 eval "$("$HOME/.local/bin/starship" init zsh)"
261fi
262EOF
263
264 ok ".zshrc configured for Oh My Zsh framework with Starship prompt"
265}
266
267configure_git_identity() {
268 log "Configuring global Git identity..."
269 git config --global user.name "Vernon Wee Hong KOH"
270 git config --global user.email "261549452+weehong@users.noreply.github.com"
271 ok "Global Git identity configured"
272}
273
274switch_shell() {
275 log "Starting Zsh session..."
276 echo -e "${YELLOW}Type 'exit' to return to this installer menu.${NC}"
277 echo "----------------------------------------"
278 zsh -l
279 echo "----------------------------------------"
280 ok "Returned from Zsh session"
281}
282
283# =============================
284# INTERACTIVE MENU
285# =============================
286show_menu() {
287 echo "==========================================="
288 echo "WSL Minimal Zsh Installer - Choose what to do"
289 echo "==========================================="
290 echo " 0) Run ALL steps (1-11)"
291 echo " 1) Update system packages"
292 echo " 2) Install core packages (zsh, git, vim, etc.)"
293 echo " 3) Set Timezone (best effort)"
294 echo " 4) Install Homebrew"
295 echo " 5) Configure shell (chsh - sets default shell)"
296 echo " 6) Install Oh My Zsh + plugins"
297 echo " 7) Install Starship prompt"
298 echo " 8) Download custom configs (from OpenGist)"
299 echo " 9) Configure ~/.zshrc (Oh My Zsh + Starship)"
300 echo "10) Configure global Git identity"
301 echo "11) Switch to Zsh (Temporary Sub-shell)"
302 echo "12) Quit"
303 echo "==========================================="
304}
305
306run_choices() {
307 local input
308 read -p "Select: " input
309 input="${input//,/ }"
310
311 local -a to_run=()
312 local -a to_exclude=()
313
314 for item in $input; do
315 if [[ "$item" == !* ]]; then
316 to_exclude+=("${item:1}")
317 elif [[ "$item" == "0" ]]; then
318 to_run+=(1 2 3 4 5 6 7 8 9 10 11)
319 else
320 to_run+=("$item")
321 fi
322 done
323
324 for choice in "${to_run[@]}"; do
325 local skip=false
326
327 for ex in "${to_exclude[@]}"; do
328 if [[ "$choice" == "$ex" ]]; then
329 skip=true
330 break
331 fi
332 done
333
334 $skip && continue
335
336 case "$choice" in
337 1) update_system ;;
338 2) install_packages ;;
339 3) set_timezone ;;
340 4) install_homebrew ;;
341 5) configure_shell ;;
342 6) install_oh_my_zsh ;;
343 7) install_starship ;;
344 8) download_configs ;;
345 9) configure_zshrc ;;
346 10) configure_git_identity ;;
347 11) switch_shell ;;
348 12) log "Exiting..."; exit 0 ;;
349 *) warn "Skipping invalid option: $choice" ;;
350 esac
351 echo
352 done
353}
354
355# =============================
356# MAIN
357# =============================
358main() {
359 check_requirements
360 while true; do
361 show_menu
362 run_choices
363 read -p "Do you want to run more options? (y/n): " again
364 [[ "$again" =~ ^[Yy]$ ]] || break
365 done
366 ok "WSL Zsh installation/configuration complete!"
367}
368
369main "$@"
370
zshrc Originalformat
1# =============================================================================
2# 1. HELPER FUNCTIONS & PATH
3# =============================================================================
4source_if_readable() {
5 local file="$1"
6 if [[ -f "$file" && -r "$file" ]]; then
7 source "$file"
8 fi
9}
10
11# Ensure local bin is in PATH early (catches manual Starship installations)
12export PATH="$HOME/.local/bin:$PATH"
13
14# =============================================================================
15# 2. OH MY ZSH FRAMEWORK
16# =============================================================================
17export ZSH="${ZSH:-$HOME/.oh-my-zsh}"
18ZSH_THEME=""
19
20plugins=(
21 git
22 zsh-autosuggestions
23 zsh-syntax-highlighting
24)
25
26source_if_readable "$ZSH/oh-my-zsh.sh"
27
28# =============================================================================
29# 3. THIRD-PARTY INITIALIZATION & CUSTOM CONFIGS
30# =============================================================================
31# Load external initializers (SDKMAN, NVM, etc.)
32source_if_readable "$HOME/.sourcerc"
33
34# Custom Functions (must load before Path Management)
35source_if_readable "$HOME/.func"
36
37# Path Management (Relies on append_path from .func)
38source_if_readable "$HOME/.pathrc"
39
40# Aliases (Loaded late so they override framework/system defaults)
41source_if_readable "$HOME/.alias"
42
43# =============================================================================
44# 4. STARSHIP PROMPT
45# =============================================================================
46if [[ -z "${STARSHIP_CONFIG:-}" && -f "$HOME/.config/starship.toml" ]]; then
47 export STARSHIP_CONFIG="$HOME/.config/starship.toml"
48fi
49
50# Starship owns the prompt. It must initialize after Oh My Zsh.
51if command -v starship >/dev/null 2>&1; then
52 eval "$(starship init zsh)"
53elif [[ -x "$HOME/.local/bin/starship" ]]; then
54 eval "$("$HOME/.local/bin/starship" init zsh)"
55fi
56