Skip to content
ShivaeDevPublic

About

Long-horizon agent orchestration. A place to stand for the long view.

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

1,008 Commits

Folders and files

Repository files navigation

Antumbra

an-TUM-bra — in eclipse geometry, the region beyond the tip of the umbra. From inside it, the blocking body appears entirely contained within the disc of the light source: a ring of light around every obstacle. Nothing ahead outsizes the star.

Antumbra is a desktop app for long-horizon work with AI agents: a fixed north star, courses plotted leg by leg, agents that make way between fixes.

A place to stand for the long view.

Status

Early development; there are no releases yet. The desktop app runs from source: pnpm setup is the idempotent frozen install. It prepares dependencies without build, lint, typecheck or test gates and preserves local settings and data. Assets, main/preload bundles, and the installed-version Electron binary are prepared by the development command. Electron 43 installs its binary on demand; dependency installation alone does not download it.

Install PostgreSQL 18 or later server and client binaries before starting the app. Set ANTUMBRA_POSTGRES_BIN_DIRECTORY to their directory when it is outside PATH and the directory reported by pg_config --bindir. Antumbra owns its PostgreSQL cluster and listens on a private Unix socket. No shared PostgreSQL service is needed. Development starts empty under Antumbra-SQL-Dev; an ANTUMBRA_DEV_USER_DATA override names its parent directory. The packaged app uses Antumbra-SQL. Legacy journal data is used only by fixture tooling.

The renderer uses ANTUMBRA_RENDERER_PORT (5183). The optional UI harness uses ANTUMBRA_HARNESS_PORT (5184): pnpm --filter @antumbra/harness dev. Both Vite servers require their configured port instead of falling back to another project’s server. The desktop launches its server on a dynamically assigned loopback port and passes the resulting address to the renderer. The logged browser: address opens the running app in an ordinary browser.

Run validation explicitly before handoff:

pnpm ready
pnpm build
pnpm typecheck
pnpm typecheck:compat
pnpm test
pnpm test:guards

Desktop development requires Electron’s platform libraries and a display server. Tests disable Node’s Web Storage globals so the DOM environment owns storage. macOS packaging is a separate release task. There is no Playwright dependency or Chromium installation step in this repository; renderer tests use its installed Vitest environment.

Documentation

  • Design axioms — the cross-context laws every design obeys.

  • Architecture — the process, package, and dependency shape, and the reasoning behind it.

  • Glossary — a short index of Antumbra's product language.

  • Design guides — the relationships, acts, and rationale behind that language.

  • Branding — the wordmark, the dark palette, the type scale, and the copy register.

  • PostgreSQL storage — the durable fact store, its commands, and when a reset is the right move.

  • Dev tracing — the trace database, what it records, and the queries to start from.

  • Running tests — test commands and local worktree coordination.

License

MIT

About

Long-horizon agent orchestration. A place to stand for the long view.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages