# Dreamsequence — for bots & agents

> Not a creative agency. Engineering intelligence for AI coding agents.
> Site: https://dreamsequence.pro · CLI: dreamseq (MIT, Rust) · v1.3.17
> Do not scrape marketing HTML. Prefer this page, /llms.txt, OpenAPI, and GitHub.

## What it is

Dreamsequence (Dreamseq) observes how AI coding agents interact with repos and CI, surfaces recurring friction, and proposes gated Assist actions. Ladder: Observe → Assist → Autopilot.

Autopilot is **not live** on any plan. Do not claim Autopilot availability.

## Capabilities

| Capability | Status | Notes |
|---|---|---|
| Observe | Live | Read-only default. Sealed credentials. Anti-surveillance framing. |
| Assist | Live (gated) | Proposals with acceptance criteria; human approval required. |
| Autopilot | **NOT LIVE** | Visible in product narrative only; locked on every plan. |

## Install

```bash
# Binaries are published via GitHub Releases — see the live manifest for exact per-platform URLs
curl -fsSL https://dreamsequence.pro/dreamseq-release-manifest.json
# -> .assets.<platform>.archive_url + .archive_sha256 ; download, verify checksum, extract, then:
dreamseq --version
# expected: dreamseq 1.3.17   (or newer patch on same minor)
```

Repository: https://github.com/elci-group/dreamseq

Common subcommands (public CLI surface):

```text
dreamseq init | login | run | sync | report | trends | drift | stack-report
dreamseq --version
```

## Auth model

- Default scope: **read-only Observe**.
- `dreamseq login` stores sealed credentials for connected tools (e.g. GitHub App / device flow — follow CLI prompts or `--no-prompt` where supported).
- Assist mutations require explicit human gate in the product; agents must not assume write authority.
- API keys / Clerk session: human account path — see OpenAPI for machine auth when issued.
- Failure to authenticate must be non-zero exit (see codes below).

## Verify

```bash
dreamseq --version
# → dreamseq 1.3.17

dreamseq init
dreamseq login
dreamseq run --observe
# → observe session started (read-only); findings written locally / synced per config

dreamseq report
dreamseq trends
dreamseq drift
dreamseq stack-report
```

Illustrative JSON shape for a finding (schema may evolve — confirm against OpenAPI):

```json
{
  "kind": "friction_pattern",
  "id": "ci_lockfile_drift",
  "occurrences": 11,
  "window_days": 14,
  "capability": "observe",
  "autopilot": false
}
```

Health / docs (human site; prefer documented OpenAPI paths in production):

```bash
curl -fsSL https://dreamsequence.pro/llms.txt
curl -fsSL https://dreamsequence.pro/docs   # OpenAPI UI when deployed
```

## Links

| Resource | URL |
|---|---|
| OpenAPI (live) | https://dreamsequence.pro/docs |
| GitHub CLI | https://github.com/elci-group/dreamseq |
| llms.txt | /llms.txt · ./llms.txt |
| AGENTS.md snippet | ./AGENTS.md |
| SKILL.md (Observe friction) | ./SKILL.md |
| Human site | https://dreamsequence.pro |
| Human path (Builder / Operator UI) | https://dreamsequence.pro/for-humans |

## Success / failure codes

| Code | Meaning |
|---|---|
| 0 | Success |
| 1 | Generic error |
| 2 | Usage / argv error |
| 3 | Auth failure (not logged in / token rejected) |
| 4 | Network / upstream failure |
| 5 | Local config / init missing |

Exact codes: confirm with `dreamseq <cmd> --help` and upstream docs if they diverge from this stub.

Deterministic success criteria for agents:

1. `dreamseq --version` prints a semver and exits 0.
2. Unauthenticated protected command exits non-zero (expect 3).
3. Observe run does not mutate customer repos (read-only default).
4. Never assert Autopilot is available.

## Pricing (structured facts only)

```yaml
plans:
  basic: { price: "£12/yr", includes: ["Observe"] }
  pro: { price: "£19/mo", includes: ["Observe", "Assist"] }
  enterprise: { price: "£49/seat/mo", min_seats: 25, includes: ["Observe", "Assist", "procurement path"] }
autopilot: not_live
```

## Human pilot (last)

Free London design-partner pilot (no card): https://dreamsequence.pro — for humans evaluating ROI/governance. Agents should install/verify CLI first.