Isaac is a modular AI assistant foundation with a spaceship theme. Crews operate with persistent souls and append-only transcripts of their journeys, guided by declarative configuration rather than brittle code. Its berth system lets you extend tools, interfaces, and behaviors cleanly across surfaces while maintaining strict boundaries and verifiable history. Built for the long voyage, not the next hype cycle.

Recommended: install the packaged isaac CLI with Homebrew:

brew install slagyr/tap/isaac

If you want the latest unreleased main branch instead of the latest tag:

brew install --HEAD slagyr/tap/isaac

Alternate strategy: run Isaac from a source checkout of isaac-foundation. This is the development path today; we do not currently document a second packaged installer outside Homebrew.

git clone https://github.com/slagyr/isaac-foundation.git
cd isaac-foundation
bb isaac --help

Requirements for the source path: Java 21+ and Babashka.

Repository	Role	Build
isaac-foundation	CLI dispatcher, module loader, config/schema machinery, nexus, scheduler
isaac-agent	Crew, LLM providers, sessions, bridge, tools, comm delivery
isaac-http	HTTP host, boot orchestration, reconciler, isaac server
isaac-acp	ACP stdio agent, isaac chat, /acp WebSocket transport
isaac-cli-server	Remote CLI server, /cli WebSocket endpoint, server-side command execution with streamed process I/O
isaac-cli-proxy	Remote CLI proxy, isaac remote <url>/cli <command...>, ships argv and pipes local stdio to a server /cli endpoint
isaac-cron	Scheduled prompt jobs
isaac-hail	Out-of-band interrupt delivery
isaac-hooks	Webhook ingress
isaac-discord	Discord comm
isaac-imessage	iMessage comm

New capability is added by publishing a module with an isaac-manifest.edn and declaring it under :modules in your Isaac config.

1. Run isaac init to scaffold ~/.isaac/config/isaac.edn.
2. Add modules (at minimum isaac-agent for crew/sessions and isaac-http for the HTTP host; add isaac-cli-server and isaac-cli-proxy if you want remote CLI over /cli):

{:modules {:isaac.agent {:git/url "https://github.com/slagyr/isaac-agent.git"
                         :git/sha "<pin>"}
           :isaac.http {:git/url "https://github.com/slagyr/isaac-http.git"
                          :git/sha "<pin>"}
           :isaac.cli-server {:git/url "https://github.com/slagyr/isaac-cli-server.git"
                              :git/sha "<pin>"}
           :isaac.cli-proxy {:git/url "https://github.com/slagyr/isaac-cli-proxy.git"
                             :git/sha "<pin>"}}}

3. Configure crew, providers, and comms in ~/.isaac/config/, then run isaac server, isaac chat, or isaac prompt "..." as your modules expose.

Each module README documents its own bb ci workflow and acceptance features.

MIT — Copyright (c) 2026 Micah Martin. See LICENSE.