Structured CLI

Let your AI agent plan your day.

The Structured CLI gives coding agents like Claude Code, Codex, and Cursor direct access to your timeline and Inbox, right from the terminal they already work in.

Install with Homebrew About Structured

The recording needs JavaScript to play.

Shown with Codex. Any agent that can run shell commands works, including desktop apps.

Before you start

Homebrew. The CLI is distributed through a Homebrew tap. If brew --version prints nothing, install Homebrew from brew.sh first.
macOS or Linux. macOS 14 or later on Apple Silicon, or Linux on arm64 or x64.
A Structured account. Sign in with the account you use in the app, or create one during login.

Get set up in three steps

Install the CLI

Add the Structured tap and install the prebuilt binary.
```
brew tap unorderly/tap
brew install structured
```
Installs structured and the shorter strct alias.
Sign in

Opens your browser to sign in with Apple, Google, or email. You only do this once.
```
structured login
```
No browser on this machine? Use structured login --email you@example.com and enter the code from your inbox.

Hand it to your agent

Paste this into your agent's instructions file, such as AGENTS.md or CLAUDE.md, or straight into a chat.

## Structured (daily planner)

Use the `structured` CLI to read and manage my tasks.

- Pass `--json` and parse the output. Errors are JSON on stderr with a non-zero exit code.
- Read: `structured today --json`, `structured tomorrow --json`, `structured inbox --json`.
- Create: `structured add "Title" today 2pm 45m --json`. Without a date or time the task goes to the Inbox.
- Change: `structured edit <id>`, `structured complete <id>`, `structured delete <id>`. Take task IDs from the JSON output.
- Run `structured <command> --help` before using a command for the first time.
- Ask me before deleting tasks.

Built for agents

JSON everywhere: Add --json to views and task commands for output an agent can parse instead of guess at.
Clear failures: Errors come back as JSON on stderr with a non-zero exit code, so agents notice and recover.
Stable task IDs: Every task has an ID, and any unique prefix works for show, edit, complete, and delete.
In sync with your apps: Changes sync through Structured Cloud and show up in Structured on your phone, Mac, and the web.

Stay up to date

brew upgrade structured