live

RepoGarden

Developer tools
Preview unavailable The details below still apply. RepoGarden terminal habitat preview showing local repositories as a pixel garden.
Public RepoGarden preview

A little local habitat where your repos live.

Product, design, and engineering · 2026

A local-first terminal app that turns the repositories on a machine into a deterministic pixel habitat, with rooms, journal entries, repo notes, recent commits, and optional GitHub discovery.

Source is public on GitHub, and the CLI installs from npm.

Read case study brief · what i owned · key decisions · what shipped · evidence · implementation

The problem

Side projects pile up faster than anyone can keep the context for them. A normal dashboard adds upkeep and guilt, when what a solo builder needs is to remember where the work stopped and pick one small next move.

What I owned

  • I did the product direction, interaction design, visual system, public documentation, packaging, and the TypeScript implementation.
  • The repository is public under MIT, so the product rationale, architecture, tests, and release history are all there to read.

Key decisions

  • Replaced a heavier Tauri and Pixi desktop prototype with a terminal-native Node and Ink product, and kept the spatial habitat idea.
  • Generate each creature from its repository’s identity, so it comes out the same every time and there’s no asset pack to maintain.
  • Use soft state cues, and leave out productivity scores, punishment, surveillance framing, and fake certainty.
  • Keep notes and memory in local JSON and Markdown files you can open and read, and never write to the repositories being watched.

What shipped

  • A single-process Node CLI built with React 19 and Ink 7, not a hosted dashboard.
  • It scans the local roots you configure, keeps its state in ~/.repogarden, and never writes to the repositories it watches.
  • Garden, room, journal, and per-repo workbench views, all with reduced-motion support.

Evidence

  • The public MIT-licensed source has the complete implementation, product vision, privacy model, tests, and release history.
  • Version 0.9.4 is public on npm as the @outsideheaven/repogarden CLI.
  • Preview and demo captures show the terminal habitat, first-run flow, and repository workbench.

Implementation

  • TypeScript
  • React
  • Ink
  • CLI