Galaxy

Galaxy brain for Claude Code — Multi-agent orchestration tools for Claude Code.

Tools

Installation

See SETUP.md for the full setup guide — prerequisites, CLI tool installs, and Galaxy.app build.

Tool Overview

statusline

A customizable status line for Claude Code sessions that displays:

• Working directory (width-adaptive)
• Git branch and status (ahead/behind, dirty, staged, stashed)
• Context window usage (visual progress bar with color thresholds)
• Model name and session cost

Example output:

~/projects/galaxy[main=*] | ████████████░░░░░░░░ 62% | Sonnet | $0.42

See tools/statusline/README.md for detailed documentation.

snapshots

Session snapshot management for Claude Code. Captures and restores session context snapshots, enabling persistent context across sessions.

See tools/snapshots/ for detailed documentation.

artifacts

Session artifact management for Claude Code. Stores, retrieves, and manages documents, data exports, diagrams, and other files produced during a session.

See tools/artifacts/ for detailed documentation.

timeline

Session timeline event recording for Claude Code. Records timestamped events across the Galaxy ecosystem, providing a unified chronological log of session activity (starts, stops, clears, snapshots, etc.).

See tools/timeline/ for detailed documentation.

agents

Subagent lifecycle tracking for Claude Code. Records when agents start, stop, fail, or are abandoned, with timeline event publishing and real-time socket notifications.

See tools/agents/ for detailed documentation.

diff

Structured diff capture for code review in Galaxy.app. Parses git diff output, reads full before/after file contents, and emits .gdiff JSON to stdout. Pipe into galaxy-artifacts save to produce an annotatable diff artifact with syntax highlighting, hunk overlay, and line-level annotations.

See tools/diff/ for detailed documentation.

files

Lets an agent open files for the user in Galaxy.app's Files tab. galaxy-files open puts them in a file set of the agent's own and brings it on screen; list, view, show, rename and delete cover the rest. The rules live in the app — an agent reads every set but never changes the user's Default set, and deletes only sets it made that hold no unsent notes — and the tool installs the galaxy:files skill that teaches an agent to use it.

Run galaxy-files --help for the commands.

Development

Each tool is self-contained in its own directory under tools/. Tools may be written in different languages, but currently all are written in Crystal.

Prerequisites

• Crystal >= 1.0.0
• Git

Building All Tools

make all                  # Build all tools
make statusline-build     # Build statusline
make statusline-test      # Test statusline
make statusline-check     # Lint + build + test statusline

Project Structure

galaxy/
├── README.md                 # This file
├── LICENSE                   # MIT License
├── CONTRIBUTING.md           # Development guidelines
├── Makefile                  # Root orchestration
├── bin/                      # Root scripts (future)
├── shared/                   # Shared code (if needed)
└── tools/
    ├── statusline/           # Status line tool
    ├── ledger/               # Continuous context management
    ├── snapshots/            # Session snapshot management
    ├── artifacts/            # Session artifact management
    ├── timeline/             # Session timeline events
    ├── agents/               # Subagent lifecycle tracking
    ├── diff/                 # Structured diff capture
    ├── files/                # Opening files in the Files tab for an agent
    └── galaxy/               # Terminal CLI launcher for Galaxy.app

License

MIT License - see LICENSE for details.