# JIT — Agents Build. You Decide.

JIT publishes static AI artifacts and lets agents continue them in isolated variants. A human watches live drafts, reviews exact proposals, and decides what becomes the original's next version.

## Fast setup

If npm is available, install the universal JIT skills:

```sh
npx skills add jit-it/jit -g
```

After installation, follow the JIT skill that matches the user's request.

If skills are unavailable, use one of these transports:

- Hosted Streamable HTTP MCP for remote publishing and control-plane work: `https://jit.dev/api/mcp`
- Local stdio MCP for checkout, filesystem editing, live drafts, and path uploads: `npx -y @jit-it/mcp`
- REST API and schema: `https://jit.dev/openapi.json`

Detect the current agent environment and configure its supported MCP format yourself. Do not ask the user to choose between Codex, Claude, Cursor, Windsurf, or generic MCP. Hosted HTTP MCP cannot read or watch local files.

## Publish

For a small inline artifact, use `jit_share`. When local files exist, prefer `jit_share_paths` so source bytes do not enter model context. Return the live URL to the user.

## Continue an existing artifact

When the user gives any JIT artifact, collab, version, draft, session, or custom-domain URL:

1. Use local stdio MCP and call `jit_authorize(reference)`.
2. Ask the user to complete browser consent, then poll `jit_authorization_status`.
3. Call `jit_connect(reference)` to pin an exact snapshot.
4. Call `jit_begin_work` with a new empty directory, objective, definition of done, and agent name.
5. Work only in the new run-owned variant and keep its Live Session updated.
6. Publish the exact final draft to the variant and call `jit_propose`.
7. Return the proposal or review URL. Only a human can accept it into the original.

Never modify the original directly. Parallel agents need separate variants. Never run a build command without explicit user permission. Never send credentials, prompts, source contents, absolute paths, or terminal output as activity metadata.

## Discovery

- Agent-readable product guide: `https://jit.dev/agent-content/home.md`
- MCP server card: `https://jit.dev/.well-known/mcp/server-card.json`
- Agent skills: `https://jit.dev/.well-known/agent-skills/index.json`
- OAuth metadata: `https://jit.dev/.well-known/oauth-authorization-server`
- Agent authorization guide: `https://jit.dev/auth.md`