← ClaudeAtlas

pynchy-developmentlisted

Use when running pynchy locally — running the app, tests, linting, formatting, prek hooks, or rebuilding the agent container. Also use when determining whether you're on the live Pynchy host or a local machine, and for debugging agent behavior-- session transcript branching, inspecting message history and agent traces in SQLite, pytest hangs, or diagnosing known codebase issues.
crypdick/pynchy · ★ 10 · AI & Automation · score 76
Install: claude install-skill crypdick/pynchy
# Pynchy Development Run commands directly—don't tell the user to run them. ## Am I on pynchy? Check `hostname` and compare it with the deployment-specific live host from local memory, environment, or the operator. If you are on that host, access services at `localhost`. Otherwise, reach Pynchy over SSH or Tailscale using that configured host. ## Commands ```bash uv run pynchy # Run the app uv run pytest tests/ # Run tests uv run ruff check --fix src/ # Lint + autofix uv run ruff format src/ # Format uvx prek==0.4.10 run --all-files # Run all repository hooks ./src/pynchy/agent/build.sh # Rebuild agent container ``` ## Managed worktrees and optional runtimes Use `new-feature create <slug> --no-agent` from the control checkout before any source or documentation edit. Work in the resulting `.worktrees/<slug>` directory; direct edits on the target branch are blocked. Setup installs dependencies but does not start a runtime. Start an isolated Pynchy runtime only when interactive diagnosis needs one. See [the feature-runtime workflow](../../../docs/contributing/new-feature.md) for create, merge, restart, and teardown commands. Do not use raw `git worktree` commands for managed features. Install or verify its host dependencies with `./scripts/install_new_feature_dependencies.py`. Private overlay edits belong in the independent personalization repository's own managed worktree, not in the public Pynchy worktree. See [editing personalization](../../