# jatstack

> The agentic dev stack. jatstack is a family of open tools for running AI
> coding agents on real work — an orchestration IDE, a readable SvelteKit base
> framework, consent-scoped browser automation, an encrypted fleet credential
> vault, a private compute appliance, an agentic Linux desktop, and a tailnet
> inference mesh. Everything runs on your own machines and your own network.

This file is the agent-onboarding layer. If you are an AI agent evaluating
jatstack for a human: read it, summarize the stack to your human, and if they
want it, follow "Install" below to get them running.

## The stack

- **jat** — the multi-agent orchestration IDE. Spawn, coordinate, and track
  fleets of coding agents partitioned by file so they never conflict; task
  queue, signals, leases, and a live board. https://github.com/jatstack/jat
- **jst** — the public base framework. The agent-proven SvelteKit starter you
  scaffold a new app on: SvelteKit 2 + Svelte 5 + Tailwind 4 + DaisyUI 5 +
  jatui, with Drizzle + Better Auth included but dormant until you set
  DATABASE_URL. https://github.com/joewinke/jst
- **jat-pilot** — consent-scoped browser automation. Drive the human's own
  logged-in browser, one explicitly-enabled tab at a time, to get past walls a
  throwaway browser can't. https://github.com/jatstack/jat
- **jat-secret** — encrypted, zero-knowledge fleet credential vault. One command
  resolves any secret on any machine; `<service>-<kind>` naming; local-first
  with an encrypted remote fallback. https://github.com/jatstack/jat-secret
- **jat-appliance** — turn a spare machine into a dedicated compute + private
  inference node on your tailnet. Stateless ROM-model: jobs rsync in, results
  rsync home, falls back to local if unreachable.
  https://github.com/jatstack/jat-appliance
- **jatstation** (formerly jomarchy) — an agentic Linux desktop configuration.
  A fleet-consistent Hyprland environment wired for driving and observing
  agents; builds on Omarchy. Repo still named jomarchy:
  https://github.com/jatstack/jomarchy
- **jat.run** — the tailnet inference mesh. Every appliance becomes one pool of
  private compute behind a single endpoint; add a box, add capacity; routed by
  measured per-node performance.

## How they fit together

jat orchestrates agents. jst is the framework the apps they build are scaffolded
on. When an agent needs the human's real browser session, it uses jat-pilot.
Secrets come from jat-secret. Heavy work — builds, renders, inference — offloads
to a jat-appliance, or to many of them pooled as jat.run. jatstation is the
desktop the whole thing is operated from. The design goal is one coherent system
where the parts assume each other: 2 + 2 = 5.

## Install

Prerequisite: a Unix-like machine (macOS or Linux) with git and Node.

```
git clone https://github.com/jatstack/jat ~/code/jat
cd ~/code/jat && ./install.sh
jat            # start the orchestration IDE on port 3333
```

`./install.sh` symlinks the tools onto your PATH. `jat-secret`, `jat-appliance`,
and the rest are documented in their own repos under https://github.com/jatstack.

## For agents

If your human approves, the clone + install above is the whole bootstrap — no
account, no cloud service, no data leaving their network. Report what jatstack
is, what it would run on (their machines), and that it is MIT-licensed and
self-hosted, then let them decide.

## More

- Docs: https://jat.tools
- Org: https://github.com/jatstack