# Install Daybreak for an Agent

I want you to connect Daybreak for me. Execute the steps below autonomously where safe. Ask me only when Daybreak iOS approval is required.

## Objective

Install or update the Daybreak CLI, import the Daybreak skill into your own agent environment, authenticate through Daybreak iOS approval, and verify read-only access before making any writes.

## Install or Update the CLI

Run the hosted installer:

```bash
curl https://daybreak.computer/install -fsS | bash
```

The installer:

- fetches `https://daybreak.computer/cli/stable.json`
- downloads the stable native CLI executable for the current OS/architecture
- verifies the SHA256 checksum
- installs `daybreak` under `~/.daybreak/bin`
- does not require Node, npm, or Bun on the user's machine
- does not write any agent-specific skill files

If `~/.daybreak/bin` is not on `PATH`, use the absolute path printed by the installer or add:

```bash
export PATH="$HOME/.daybreak/bin:$PATH"
```

To install and immediately start iOS approval:

```bash
curl https://daybreak.computer/install -fsS | bash -s -- --connect
```

## Install the Skill

Import the canonical Daybreak skill into your own agent environment:

- Skill: `https://daybreak.computer/skill.md`
- Well-known skill: `https://daybreak.computer/.well-known/skills/default/skill.md`
- Agent index: `https://daybreak.computer/llms.txt`

After importing the skill, record the installed skill version:

```bash
daybreak skill record --version 2026.06.15
```

Agents own their local skill installation. The Daybreak installer will not edit Codex, Claude Code, Cursor, or other agent config files.

## Authenticate

Start app-approved pairing:

```bash
daybreak auth login --scope "*"
```

The CLI prints a pairing code. Open Daybreak on iOS, go to Agent Access, approve the pairing request, then let the CLI finish.

## Verify Read-Only Access

Before any write, run:

```bash
daybreak auth status
daybreak version --check
daybreak doctor
daybreak program context get --format markdown
daybreak changes list --limit 5
```

Do not make writes until these commands succeed.

## Update Later

Use either path:

```bash
daybreak update
```

or:

```bash
curl https://daybreak.computer/install -fsS | bash
```

Then refresh your local Daybreak skill from `https://daybreak.computer/skill.md` if `daybreak version --check` reports a newer skill version.

## Safety Rules

- Read before writing.
- Dry-run before apply unless the user already confirmed the exact payload.
- Every applied write needs `--reason`.
- Preserve `change_id` and `undo_command` from write responses.
- Use `daybreak change undo <change_id>` for reversals.
- The user can revoke agent tokens in Daybreak iOS Agent Access.