ClaudeMods
☰
All projectsCommunity submissionsPromptsToolsFree toolsGuidesSponsors1 feed slots leftDashboards & HUD325Usage & costs65Security & privacy67Memory & context27Workflows & CI342Git & code review42Multi-agent orchestration136Prompts & input33Notifications & reminders44Games & entertainment79Themes & appearance71Audio & multimedia13Tools & integrations125Development & debugging31Other109
EN
● 0 online · Views 0 times
SponsorsSubmit a project
GitHub repositories · by ray-manaloto

coordinator-handoff

Auto-submits /coordinator-handoff when a dotfiles coordinator session's context reaches the configured limit, with a visible status-line heartbeat

ray-manaloto@ray-manaloto

ray-manaloto/dotfiles/tree/main/.claude/skills/coordinator-handoff

Translated

About this mod

A Claude Code plugin bundled in the ray-manaloto/dotfiles repository as a skill named coordinator-handoff. Its register.ts hook monitors the coordinator session's context usage and automatically submits /coordinator-handoff once the configured limit is reached, while displaying a status-line heartbeat. Behavior is tunable through environment variables such as DOTFILES_COORDINATOR_HANDOFF_PCT, DOTFILES_COORDINATOR_HANDOFF_STEP_PCT, DOTFILES_COORDINATOR_HANDOFF_PROBE, and DOTFILES_COORDINATOR_HANDOFF_DRY_RUN.

Installation

Check the author's README for the marketplace and plugin name first. Commands may change as the repository evolves.

claude plugin marketplace add ray-manaloto/dotfiles
claude plugin install coordinator-handoff
Original text / README

Reproducible Dotfiles (AMD64)

A highly resilient, declarative dotfiles setup using Chezmoi, Mise, and Python, optimized for Linux-based devcontainers.

Quick Start

Local Development

mise install                                       # Install all tools
mise run lint                                      # Run lint checks (read-only ≡ CI; `mise run fmt` auto-fixes)
uv run --project python pytest tests/ -x -q      # Run all 190 tests

Docker Build

docker buildx bake dev-load                        # Build devcontainer locally

Bootstrap (Container)

curl -fsSL https://raw.githubusercontent.com/sortakool/dotfiles/main/install.sh | bash

Architecture

  1. Stage 0: install.sh bootstraps mise.
  2. Stage 1: mise installs git, chezmoi, and uv.
  3. Stage 2: chezmoi init clones the repo and applies templated configs.
  4. Stage 3: Python lifecycle hooks (uv run) handle complex orchestration and tool installations.

Features

  • Strictly AMD64: Forced x86_64 architecture for container consistency.
  • Declarative Config: Pydantic DotfilesConfig centralizes 16 env vars; hk.pkl for git hooks with shared hk-common.pkl checks.
  • Zero-Bash: Logic is encapsulated in a typed, linted Python library (dotfiles_setup).
  • Zero Lint Suppressions: No noqa, type: ignore, or pylint: disable — enforced by no_lint_skip hk step.
  • Environment Auditor: Built-in health checks for identity, toolchains, and SSH connectivity.
  • CI/CD: GitHub Actions — lint → contract-preflight → a changes path-gate → base-prep → p2996-prep → build → smoke-test (smoke + Dive); promote retags on main; benchmark + Trivy run async in image-analysis.yml. Docs-only changes skip the build chain.

Tool Management

All tools are declared in mise.toml and installed via mise install. Python dependencies are managed via uv with python/pyproject.toml.

Local Testing

uv run --project python pytest tests/ -x -q      # All tests
uv run --project python dotfiles-setup verify run # Contract verification
mise run pin-actions                                # Verify GHA SHA-pinning
mise run lint-docs                                  # Validate agent documentation

Similar projects