# One Track CLI

One Track in your terminal. Tracks, entries, and their dependencies — from the same shell your work already lives in.

## Download

One command. The script detects your platform, fetches the right binary, and places `one_track` on your PATH.

### macOS

Apple Silicon and Intel are both covered.

```sh
curl -fsSL https://one-track.app/install.sh | sh
```

### Linux

x86_64 and aarch64 are both covered.

```sh
curl -fsSL https://one-track.app/install.sh | sh
```

### Windows

Runs natively in PowerShell — no WSL required.

```powershell
irm https://one-track.app/install.ps1 | iex
```

Then confirm the train is on the rails — `one_track --help` lists the available commands:

```
login       Sign in and unlock your end-to-end-encrypted data in one step
logout      Revoke the saved session and delete local credentials
unlock      Re-unlock encrypted data (recovery; login already does this)
lock        Forget the cached encryption identity
whoami      Show who is signed in and whether the session is valid
list        Show all tracks and their entries in dashboard order
show        Show one entry in full, including its dependencies
add         Add an entry, optionally wired into the dependency graph
done        Mark an entry as done
reopen      Reopen a completed entry
rm          Delete an entry
edit        Edit an entry's title, description, or track
link        Make one entry depend on another
unlink      Remove a dependency between two entries
track       Manage tracks (list, add, edit, rm)
account     Show the current plan
upgrade     Upgrade the account plan
downgrade   Downgrade the account plan
org         Organization administration
share       Share tracks with other accounts by email
visibility  Manage a track's visibility inside an organization
github      Link entries to GitHub issues and manage agent dispatch
agent       Process deliveries and complete entries from an agent environment
```

## Connect Your Agent

Agents drive One Track by invoking `one_track` directly — every command takes `--json` for machine-readable output. The complete agent guide (authentication, task management, sharing, GitHub integration) is at [one-track.app/app?format=md](https://one-track.app/app?format=md).

An MCP server (`one_track mcp`) is in development but is not part of the released CLI yet; until it ships, register nothing and call the CLI directly.