Monorepo

This repository contains multiple independent projects.

Projects

Project	Status	Notes
dissect	beta	Go tool for structural code refactoring; feature set continues to grow.
markdown-format	alpha	Markdown formatter; command surface and formatting rules are still evolving.
prrun	deprecated	Was designed to run binaries from PR releases; PR releases are no longer created.
printpdf	beta	Markdown/web-to-PDF tool; rendering pipeline has known gaps documented in project issues.
beads-merge	merged	Merged into beads. See #240.
ingest	pre-alpha	Data ingestion orchestrator; schema and connectors change frequently.
diagram-dsl	pre-alpha	TypeScript DSL for diagrams; layout system under active refactor.
mdbook-comments	alpha	mdbook preprocessor for paragraph-level commenting with Supabase backend.
want	alpha	Planning/fulfilment assistant; core design still in flux.
conf	alpha	Smart configuration manager; command coverage incomplete.
tk	beta	System-wide event-sourced task tracker; v0 implements basic claims and authority lattice.
jj-run	alpha	Jujutsu subcommand to execute shell commands against multiple revisions.
jj-run-py	deprecated	Old version of jj-run written in Python.
tk-vscode	alpha	VS Code extension that lists tk tasks by running tk ls --json.
aihook	alpha	Claude Code hook validator that enforces shell scripting best practices.
lion	alpha	Documentation extraction tool that generates markdown from special comments in Go code.

Libraries

Library	Status	Notes
configschema	alpha	Centralized schema registry for configuration tools (jj, mise, starship, claude); schemas updated via mise task.
ghclient	alpha	GitHub API client helper; used by ghrelease and other tools.
ghrelease	beta	Helper for fetching GitHub release assets; API may change without notice.
svghatch	alpha	Replaces solid colors in SVG files with line patterns for black and white printing.
toml	beta	Surgical TOML editor with comment preservation; used by conf.
version	stable	Shared version command implementation for CLI tools.
cli	stable	Unified CLI color/styling utilities for all tools.
linters/uselesswrapper	alpha	Static analysis tool that detects useless function wrappers; integrated via Dagger and mise.

Infrastructure

Project	Status	Notes
.dagger	alpha	Dagger module for building, testing, and linting all Go projects.

Installing Tools

Quick Install

Use the install script to easily download and install the latest version:

# Install latest version from main
curl -fsSL https://raw.githubusercontent.com/neongreen/mono/main/install.sh | bash -s dissect

# Install specific version
curl -fsSL https://raw.githubusercontent.com/neongreen/mono/main/install.sh | bash -s dissect main.5

Or download the script and run it locally:

wget https://raw.githubusercontent.com/neongreen/mono/main/install.sh
chmod +x install.sh
./install.sh dissect main.1

Manual Install

1. Go to the Releases page
2. Find the release you want (e.g., dissect--main.1)
3. Download the binary for your platform
4. Make it executable and move to your PATH:

# Linux/macOS
chmod +x <binary-name>
sudo mv <binary-name> /usr/local/bin/<tool-name>

Supported Platforms

• Linux: amd64, arm64
• macOS: amd64 (Intel), arm64 (Apple Silicon)

Releases

Go projects in this repository are automatically released:

• Main branch releases: Created on every push to main (e.g., dissect--main.1, dissect--main.2)

Main channel releases are considered unstable snapshots unless explicitly tagged. Stable channels are being defined (see bd-313).

Homebrew formulas for the Go CLIs (ingest, want, printpdf, conf, dissect, markdown-format, prrun, tk) are published to neongreen/homebrew-mono. Tap it with brew tap neongreen/mono and install what you need:

brew tap neongreen/mono
brew install ingest
brew install want
brew install printpdf
brew install conf
brew install dissect
brew install markdown-format
brew install prrun
brew install tk

See Release Workflow Documentation for more details.

Testing Changes

To test changes before they're merged:

1. Check out the branch locally
2. Build and test the tool manually

For testing released versions, see the Releases section above.

Development

Each project has its own development workflow and documentation. See the individual project directories for details.

Issue Tracking with tk

This repository uses tk for issue tracking. tk is an event-sourced task tracker with claims-based status, metadata support, and multi-machine sync.

Quick Reference:

# List tasks
tk ls                        # All tasks
tk ls -p want                # Want tool tasks
tk ls -p mono                # Repo-wide tasks

# Create task
tk new "Fix bug" --project want
tk new "Update CI" --project mono

# Update status
tk mark want-1 wip           # Mark as in progress
tk mark want-1 done          # Complete

# View details
tk show want-1

# Add metadata
tk meta set want-1 priority 1
tk meta set want-1 labels '["bug"]'

Tasks are tracked in ~/.tk/tk.db (event-sourced SQLite database).

Custom database location:

export TK_DB_PATH=/custom/path/tk.db
tk ls  # Uses custom database

See AGENTS.md for complete documentation.

CI/CD

• Each project has its own test workflow
• All Go projects are automatically released via .github/workflows/release.yml
• See CI Guidelines for workflow structure

Contributing

See individual project READMEs for contribution guidelines.