Tusk

Native Postgres GUI for macOS, Linux, and Windows. A Postico replacement, written in TypeScript, compiled by Perry, driven by @perry/postgres.

This repo is the application — the connection chooser, workbench shell, modes (Content / Structure / Indexes / Info / Query), keyboard handling, and intra-repo glue between the data driver and the UI components.

The two reusable components live in sibling repos:

• TuskQuery/grid — virtualized data grid.
• TuskQuery/sql-editor — minimal SQL editor.

See tusk-spec.md for the product spec.

Layout

For local development we expect all three repos to be cloned side-by-side along with @perry/postgres:

projects/
├── perry/postgres/        # @perry/postgres
└── tusk/
    ├── tusk-grid/         # TuskQuery/grid
    ├── tusk-sql-editor/   # TuskQuery/sql-editor
    └── tusk-app/          # this repo

tusk-app/package.json references the others via file: paths, so bun install links them in place.

Build

bun install
bun test
bun run typecheck

perry compile src/app.ts -o ./app    --target macos
perry compile src/app.ts -o ./app    --target linux
perry compile src/app.ts -o ./app.exe --target windows

Status

Pre-D1: scaffolded, boots an empty placeholder window. Connection chooser, schema sidebar, modes, and inline edit land per the milestones in tusk-spec.md.

License

MIT.