Dotfiles

https://github.com/tak848/dotfiles
Admin
A personal dotfiles repository managed with chezmoi for macOS and Linux, featuring automatic setup...
Tokens:9,381
Snippets:148
Trust Score:7.8
Update:6 months ago
Show doc for...
Tokens:
Raw
### Bootstrap mise Installation

Source: https://context7.com/tak848/dotfiles/llms.txt

Self-contained script for installing and verifying mise.

```bash
#!/usr/bin/env bash
# dot_local/bin/executable_mise (auto-generated)
set -eu

__mise_bootstrap() {
    local cache_home="${XDG_CACHE_HOME:-$HOME/.cache}/mise"
    export MISE_INSTALL_PATH="$cache_home/mise-2026.4.3"

    # Embedded checksums for verification
    checksum_macos_arm64="c00791c18b8e..."
    checksum_linux_x64="c12dd42186d7..."

    install_mise() {
        version="2026.4.3"
        os="$(get_os)"
        arch="$(get_arch)"
        tarball_url="https://mise.jdx.dev/v${version}/mise-v${version}-${os}-${arch}.tar.zst"
        # Download, verify checksum, extract, install
    }

    test -f "$MISE_INSTALL_PATH" || install_mise
}
__mise_bootstrap
exec -a "$0" "$MISE_INSTALL_PATH" "$@"
```

--------------------------------

### Template Dotfiles with chezmoi

Source: https://context7.com/tak848/dotfiles/llms.txt

Example of OS-specific configuration using Go templates.

```bash
# dot_zshrc.tmpl - Template with conditionals
{{- if eq .chezmoi.os "darwin" }}
{{-   if eq .chezmoi.arch "arm64" }}
BREW_PATH="/opt/homebrew/bin/brew"
{{-   else }}
BREW_PATH="/usr/local/bin/brew"
{{-   end }}
{{- else if eq .chezmoi.os "linux" }}
BREW_PATH="/home/linuxbrew/.linuxbrew/bin/brew"
{{- end }}

# Conditional MySQL client setup
{{- if lookPath "brew" }}
{{-   $brewPrefix := output "brew" "--prefix" | trim }}
{{-   if stat (joinPath $brewPrefix "opt/mysql-client") }}
export PATH="{{ $brewPrefix }}/opt/mysql-client/bin:$PATH"
{{-   end }}
{{- end }}
```

--------------------------------

### Initial Setup and chezmoi Commands

Source: https://context7.com/tak848/dotfiles/llms.txt

Commands for bootstrapping the environment and managing dotfiles via chezmoi.

```bash
# macOS: Install Xcode Command Line Tools first
xcode-select --install

# Initial installation (pulls and applies dotfiles)
sh -c "$(curl -fsLS get.chezmoi.io)" -- init --apply tak848

# Update existing installation
chezmoi update

# Preview changes before applying
chezmoi diff

# Apply changes to home directory
chezmoi apply
```

--------------------------------

### Run mise Bootstrap Commands

Source: https://context7.com/tak848/dotfiles/llms.txt

Commands to regenerate the bootstrap script and manage mise installation.

```bash
# Regenerate bootstrap script when mise version changes
task mise:bootstrap

# Bootstrap installs mise on first run, then proxies all commands
~/.local/bin/mise install   # First: downloads mise, then runs install
~/.local/bin/mise --version # Subsequent: directly executes cached mise
```

--------------------------------

### Manage Claude Code Plugins

Source: https://context7.com/tak848/dotfiles/llms.txt

Commands to update and install plugins via the CLI.

```bash
# Update and install plugins (run automatically via chezmoi)
claude plugin marketplace update
claude plugin install aws-knowledge
claude plugin install temporal
```

--------------------------------

### Kiro Steering Initialization

Source: https://github.com/tak848/dotfiles/blob/main/AGENTS.md

Initializes the Kiro steering process, loading the entire .kiro/steering/ directory as project memory. This sets up the context for subsequent commands.

```bash
/prompts:kiro-steering
```

--------------------------------

### Execute Multiple Tasks in Implementation Phase

Source: https://github.com/tak848/dotfiles/blob/main/dot_codex/prompts/kiro-spec-tasks.md

Execute multiple tasks sequentially in the implementation phase. Use with caution and clear context between tasks to avoid context bloat.

```bash
/prompts:kiro-spec-impl $1 1.1,1.2
```

--------------------------------

### Kiro Custom Steering Initialization

Source: https://github.com/tak848/dotfiles/blob/main/AGENTS.md

Initializes Kiro steering with custom configuration files. This allows for tailored project memory beyond the default files.

```bash
/prompts:kiro-steering-custom
```

--------------------------------

### Build and Use Statusline Utility

Source: https://context7.com/tak848/dotfiles/llms.txt

Commands to compile the Go utility and pipe JSON data for display.

```bash
# Build the statusline utility
cd go && go build -o cc-statusline ./cmd/cc-statusline

# Usage: pipe Claude Code JSON status to format for display
echo '{"model":{"display_name":"claude-3.5"},...}' | cc-statusline
# Output: [claude-3.5] ████████░░░░░░░ 32% (45k/128k)
#         $0.42 | 5:30 | +120 -45 | 5h:25% | abc123 | v1.2.3
```

--------------------------------

### Kiro Specification Initialization

Source: https://github.com/tak848/dotfiles/blob/main/AGENTS.md

Initiates the specification phase by providing a description of the desired feature. This is the first step in defining requirements.

```bash
/prompts:kiro-spec-init "description"
```

--------------------------------

### Execute All Pending Tasks in Implementation Phase

Source: https://github.com/tak848/dotfiles/blob/main/dot_codex/prompts/kiro-spec-tasks.md

Execute all pending tasks in the implementation phase. This is not recommended due to potential context bloat and is best avoided.

```bash
/prompts:kiro-spec-impl $1
```

--------------------------------

### Kiro CLI Commands

Source: https://context7.com/tak848/dotfiles/llms.txt

Commands for managing the implementation phase and tracking progress of features.

```bash
/kiro:spec-impl feature-name [task-ids]  # Execute implementation
/kiro:validate-impl feature-name         # Verify implementation

# Progress tracking
/kiro:spec-status feature-name           # Check current status
```

--------------------------------

### Execute Kiro Specification Workflow

Source: https://context7.com/tak848/dotfiles/llms.txt

Commands for AI-DLC specification and task management.

```bash
# Phase 0: Project steering (optional)
/kiro:steering              # Generate project-wide rules
/kiro:steering-custom       # Add custom steering files

# Phase 1: Specification
/kiro:spec-init "feature description"    # Initialize new spec
/kiro:spec-requirements feature-name     # Define requirements (EARS format)
/kiro:validate-gap feature-name          # Gap analysis for existing code
/kiro:spec-design feature-name [-y]      # Create technical design
/kiro:validate-design feature-name       # Review design
/kiro:spec-tasks feature-name [-y]       # Generate implementation tasks
```

--------------------------------

### mise Configuration and Management

Source: https://context7.com/tak848/dotfiles/llms.txt

Configuration for mise tools and commands for managing runtimes and CLI tools.

```toml
# dot_config/mise/config.toml
[settings]
lockfile = true
auto_install = false

[tools]
# Runtimes (core backend)
node = "24.14.1"
pnpm = "10.33.0"
go = "1.26.1"

# CLI tools (aqua backend)
"aqua:junegunn/fzf" = "0.70.0"
"aqua:BurntSushi/ripgrep" = "15.1.0"
"aqua:neovim/neovim" = "0.12.0"
"aqua:twpayne/chezmoi" = "2.70.0"

# npm global packages
"npm:@google/gemini-cli" = "0.36.0"
"aqua:anthropics/claude-code" = "2.1.98"
```

```bash
# Install all configured tools
mise install

# Generate/update lockfile for all platforms
mise lock -p linux-x64,linux-arm64,macos-x64,macos-arm64,windows-x64

# Trust a directory's mise configuration
mise trust /path/to/project
```

--------------------------------

### Kiro Feature Implementation

Source: https://github.com/tak848/dotfiles/blob/main/AGENTS.md

Implements the specified tasks for a given feature. This is the core development phase.

```bash
/prompts:kiro-spec-impl {feature} [tasks]
```

--------------------------------

### Manage chezmoi Templates

Source: https://context7.com/tak848/dotfiles/llms.txt

Commands for validating and listing managed dotfiles.

```bash
# Validate templates without applying
chezmoi --source . --dry-run --verbose apply

# View rendered template
chezmoi cat ~/.zshrc

# List managed files
chezmoi managed
```

--------------------------------

### Kiro CLI Workflow Commands

Source: https://github.com/tak848/dotfiles/blob/main/GEMINI.md

Commands used to manage the development lifecycle phases from specification initialization to implementation validation.

```text
/kiro:spec-init "description"
/kiro:spec-requirements {feature}
/kiro:validate-gap {feature}
/kiro:spec-design {feature} [-y]
/kiro:validate-design {feature}
/kiro:spec-tasks {feature} [-y]
/kiro:spec-impl {feature} [tasks]
/kiro:validate-impl {feature}
/kiro:spec-status {feature}
```

--------------------------------

### Execute Specific Task in Implementation Phase

Source: https://github.com/tak848/dotfiles/blob/main/dot_codex/prompts/kiro-spec-tasks.md

Run a specific task during the implementation phase. It is recommended to clear conversation history before executing each task for a clean state.

```bash
/prompts:kiro-spec-impl $1 1.1
```

--------------------------------

### Configure Claude Code Marketplace

Source: https://context7.com/tak848/dotfiles/llms.txt

Define custom MCP servers in the marketplace configuration file.

```json
// .claude-plugin/marketplace.json
{
  "$schema": "https://anthropic.com/claude-code/marketplace.schema.json",
  "name": "tak848-plugins",
  "plugins": [
    {
      "name": "aws-knowledge",
      "description": "AWS Knowledge MCP for documentation search",
      "version": "1.0.0",
      "source": "./claude-plugins/aws-knowledge",
      "category": "development"
    },
    {
      "name": "temporal",
      "description": "Temporal Docs MCP for framework documentation",
      "version": "1.0.0",
      "source": "./claude-plugins/temporal",
      "category": "development"
    }
  ]
}
```

--------------------------------

### aqua Configuration and Management

Source: https://context7.com/tak848/dotfiles/llms.txt

Configuration for checksum-verified tools and commands for managing them via aqua.

```yaml
# dot_config/aquaproj-aqua/aqua.yaml
registries:
  - type: standard
    ref: v4.492.0
checksum:
  enabled: true
  require_checksum: true
  supported_envs:
    - darwin
    - linux
packages:
  - name: aws/aws-cli@2.34.24
  - name: 1password/cli@v2.32.0
  - name: ajeetdsouza/zoxide@v0.9.9
```

```bash
# Install aqua-managed tools
aqua install

# Update checksums after editing aqua.yaml
aqua update-checksum --prune

# Test tool installations
cd dot_config/aquaproj-aqua && aqua install --test
```

--------------------------------

### Taskfile Automation

Source: https://context7.com/tak848/dotfiles/llms.txt

Task definitions and execution commands for project automation.

```yaml
# Taskfile.yaml excerpt
version: "3"
root: true
method: checksum

tasks:
  default:
    deps: [generate, lock]

  mise:lock:
    cmds:
      - rm -f mise.lock && mise lock -p linux-x64,linux-arm64,macos-x64,macos-arm64,windows-x64

  aqua:checksum:
    dir: dot_config/aquaproj-aqua
    cmds:
      - aqua update-checksum --prune

  mise:bootstrap:
    cmds:
      - |
        source .mise-bootstrap-version
        mise generate bootstrap -V "${MISE_VERSION#v}" -w ./dot_local/bin/executable_mise
```

```bash
# Run all generation tasks
task

# Update only lockfiles and checksums
task lock

# Individual tasks
task mise:lock        # Update mise lockfiles
task aqua:checksum    # Update aqua checksums
task mise:bootstrap   # Regenerate mise bootstrap script

# CI validation (excludes mise.lock due to platform differences)
task check
```

--------------------------------

### Kiro Project Directory Structure

Source: https://context7.com/tak848/dotfiles/llms.txt

Standard layout for Kiro-managed projects, including steering policies, feature specifications, and settings.

```text
.kiro/
├── steering/           # Project-wide policies
│   ├── product.md      # Product context
│   ├── tech.md         # Technical standards
│   └── structure.md    # Project structure
├── specs/              # Feature specifications
│   └── feature-name/
│       ├── spec.json
│       ├── requirements.md
│       ├── design.md
│       └── tasks.md
└── settings/           # Templates and rules
```

--------------------------------

### Auto-Approve Requirements and Design

Source: https://github.com/tak848/dotfiles/blob/main/dot_codex/prompts/kiro-spec-tasks.md

Use this command to automatically approve requirements and design, allowing task generation to proceed when they are not explicitly approved.

```bash
/prompts:kiro-spec-tasks $1 -y
```

--------------------------------

### Kiro Feature Requirements

Source: https://github.com/tak848/dotfiles/blob/main/AGENTS.md

Defines the specific requirements for a given feature. Use this to detail what the feature needs to accomplish.

```bash
/prompts:kiro-spec-requirements {feature}
```

--------------------------------

### Re-run Task Generation After Modifications

Source: https://github.com/tak848/dotfiles/blob/main/dot_codex/prompts/kiro-spec-tasks.md

If modifications are needed after the initial task generation, provide feedback and re-run the task generation command. Existing tasks will be used as a reference in merge mode.

```bash
/prompts:kiro-spec-tasks $1
```

--------------------------------

### Kiro Implementation Validation

Source: https://github.com/tak848/dotfiles/blob/main/AGENTS.md

Optionally validates the implementation of a feature after development is complete. This is a final check before deployment or further review.

```bash
/prompts:kiro-validate-impl {feature}
```

--------------------------------

### Git Worktree Management Functions

Source: https://context7.com/tak848/dotfiles/llms.txt

Shell functions for managing git worktrees with fzf integration.

```bash
# gwt - Switch between worktrees (preserves relative path)
gwt
# Interactive fzf selection, then switches to the same subdirectory in the target worktree

# gwr - Remove worktrees (supports multi-select)
gwr
# Shows last commit date, allows Tab for multi-select, prompts for --force if needed

# gwc - Create new worktree (versatile)
gwc                              # Interactive branch selection with fzf
gwc --pr 123                     # Create from PR number
gwc --pr https://github.com/owner/repo/pull/123  # Create from PR URL
gwc --copy .env.local            # Copy additional local files
gwc --cursor                     # Open in Cursor after creation

# Environment variable for default copy files
export GWC_COPY_FILES=".env.test,config.local.json"
```

--------------------------------

### Kiro Feature Task Specification

Source: https://github.com/tak848/dotfiles/blob/main/AGENTS.md

Specifies the tasks required to implement a given feature. The optional -y flag can be used for intentional fast-tracking.

```bash
/prompts:kiro-spec-tasks {feature} [-y]
```

--------------------------------

### Kiro Feature Status Check

Source: https://github.com/tak848/dotfiles/blob/main/AGENTS.md

Checks the current status of a feature at any point in the development cycle. Use this to maintain alignment and track progress.

```bash
/prompts:kiro-spec-status {feature}
```

--------------------------------

### Kiro Gap Validation for Existing Codebase

Source: https://github.com/tak848/dotfiles/blob/main/AGENTS.md

Optionally validates gaps in an existing codebase against feature requirements. Use this to identify missing components or discrepancies.

```bash
/prompts:kiro-validate-gap {feature}
```

--------------------------------

### Kiro Feature Design Specification

Source: https://github.com/tak848/dotfiles/blob/main/AGENTS.md

Specifies the design for a given feature. The optional -y flag can be used for intentional fast-tracking through the approval process.

```bash
/prompts:kiro-spec-design {feature} [-y]
```

--------------------------------

### Kiro Design Validation

Source: https://github.com/tak848/dotfiles/blob/main/AGENTS.md

Optionally validates the design of a feature. This step is part of the design review process before implementation.

```bash
/prompts:kiro-validate-design {feature}
```

--------------------------------

### Define Claude Code Status Data Structure

Source: https://context7.com/tak848/dotfiles/llms.txt

Go struct definition for parsing Claude Code session statistics.

```go
// go/cmd/cc-statusline/main.go
package main

type Data struct {
    Model struct {
        DisplayName string `json:"display_name"`
    } `json:"model"`
    ContextWindow struct {
        UsedPercentage    float64 `json:"used_percentage"`
        ContextWindowSize int     `json:"context_window_size"`
    } `json:"context_window"`
    Cost struct {
        TotalCostUSD      float64 `json:"total_cost_usd"`
        TotalDurationMs   int     `json:"total_duration_ms"`
        TotalLinesAdded   int     `json:"total_lines_added"`
        TotalLinesRemoved int     `json:"total_lines_removed"`
    } `json:"cost"`
    RateLimits *struct {
        FiveHour *struct {
            UsedPercentage float64 `json:"used_percentage"`
            ResetsAt       int64   `json:"resets_at"`
        } `json:"five_hour"`
    } `json:"rate_limits"`
}
```
Tokens:
Raw