Signed-off-by: Jack Amadeo <jackamadeo@squareup.com> Co-authored-by: block-open-source[bot] <201011344+block-open-source[bot]@users.noreply.github.com> Co-authored-by: block-open-source[bot] <1159699+block-open-source[bot]@users.noreply.github.com> Co-authored-by: Wes <wesbillman@users.noreply.github.com> Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com> Co-authored-by: renovate[bot] <29139614+renovate[bot]@users.noreply.github.com> Co-authored-by: Matt Toohey <contact@matttoohey.com> Co-authored-by: tulsi <tulsi@block.xyz> Co-authored-by: morgmart <98432065+morgmart@users.noreply.github.com> Co-authored-by: Bradley Axen <baxen@squareup.com> Co-authored-by: Alex Hancock <alexhancock@block.xyz> Co-authored-by: Taylor Ho <taylorkmho@gmail.com> Co-authored-by: Nahiyan Khan <nahiyan.khan@gmail.com> Co-authored-by: Lifei Zhou <lifei@squareup.com>
Goose2
Goose2 is a Tauri 2 + React 19 desktop app.
Getting Started
- If your shell cannot find
just,pnpm, orlefthook, activate Hermit. bash/zsh:source ./bin/activate-hermitfish:source ./bin/activate-hermit.fish - Install git hooks:
lefthook install - Install dependencies:
just setup - Start the app:
just dev
just clean removes Rust build artifacts, dist, and node_modules. Run just setup again before just dev.
just setup bootstraps a shared managed goose checkout in a home-level cache directory when it does not exist, fast-forwards it, builds a local goose binary, and stamps the exact branch/commit it used. just dev only does a lightweight preflight against that shared stamp; if the managed checkout is missing, stale, or built from the wrong branch, it warns and tells you to rerun just setup. By default the helper uses ~/Library/Caches/goose2-dev on macOS, or $XDG_CACHE_HOME/goose2-dev / ~/.cache/goose2-dev elsewhere. It prefers origin/baxen/goose2 and falls back to origin/main when that branch does not exist yet.
Override the shared cache root or branch with GOOSE_DEV_ROOT=/path/to/cache and GOOSE_DEV_BRANCH=my/integration-branch. You can also override the checkout path directly with GOOSE_DEV_REPO=/path/to/goose, or the clone source with GOOSE_DEV_CLONE_URL=....
Run just to list available commands, or see justfile for the full recipe definitions.
Important Files
- AGENTS.md repo conventions and agent guidance
- justfile local setup, dev, test, and CI commands
- CODEOWNERS code ownership
- .github/workflows/ci.yml CI checks
- .github/ISSUE_TEMPLATE/ issue templates
- GOVERNANCE.md project governance
- LICENSE license terms
Project leads should keep this README, CODEOWNERS, and the issue templates current. If this repo grows beyond the quick-start flow above, add a CONTRIBUTING.md and link it here once it exists.