Skip to content

Development

Jump to bottom
defangdevs edited this page Jul 5, 2026 · 2 revisions

Development notes

Working on claude-box from the maintainer's NixOS box (the agent's tmux/tool subshells), plus CI workflow tips.

Tool-subshell environment

  • nix and git aren't reliably on PATH in tool subshells. Prefix commands with: 
    export PATH=/home/claude/.nix-profile/bin:/run/current-system/sw/bin:$PATH
  • nix needs the experimental flags: --extra-experimental-features nix-command --extra-experimental-features flakes.
  • Git identity isn't configured globally — pass it per-commit via env to match the existing author (do NOT edit git config): 
    GIT_AUTHOR_NAME=defangdevs GIT_AUTHOR_EMAIL=defangdevs@users.noreply.github.com \
GIT_COMMITTER_NAME=defangdevs GIT_COMMITTER_EMAIL=defangdevs@users.noreply.github.com \
git commit ...
  • gh is authenticated and pushes as defangdevs. awk / python3 aren't installed.

CI

  • Watch runs in the FOREGROUND: gh run watch <id> --exit-status. Don't background a streaming watch — it leaves stale "Running" ghost tasks in the UI.
  • CI only runs on build-relevant paths (Nix / lockfile / workflows); doc-only pushes skip it.
  • The landing page (docs/) publishes via GitHub Pages branch source, not a workflow — a push to master that touches docs/ deploys on its own.

Clone this wiki locally