Quickstart

Install the CLI

Run the install script. It downloads the taskstation binary for your OS.

curl -fsSL https://taskstation.co/install | bash

TaskStation supports macOS and Linux. There is no Windows binary yet.

Sign in

taskstation login

This opens your browser for sign-in. After you sign in, taskstation login picks your account and a default project for you.

Create or clone a project

A new account has no projects yet, so taskstation login has none to pick. Run taskstation init with a name to create your first project. This scaffolds a project directory on your machine.

taskstation init my-app
cd my-app
taskstation ship

taskstation ship creates the project in TaskStation Cloud on its first run, then pushes your code. Run taskstation ship again any time to sync local changes.

To work on a project that already exists in TaskStation Cloud, clone it instead:

taskstation projects clone <project-id>

Find <project-id> with taskstation projects ls.

Run a session

taskstation sessions new --prompt "Build the login page"

This starts a session. The agent works in its own sandbox, on its own branch, so your project is not touched yet.

Attach to the session to watch progress and reply:

taskstation sessions chat

Review and merge the change request

When the agent finishes, it opens a change request with a summary and the exact diff.

taskstation cr ls

This lists the open CRs in your project. Review the one the agent opened, then merge it to land the work on your default branch:

taskstation cr merge 1

Replace 1 with the CR number from taskstation cr ls. Nothing reaches your project's default branch until you merge.