sick.cat API

sick.catAvailable

Private code workspaces your AI can write to, over the command line and, soon, over HTTP.

The sick command line is available today. A REST API over the same workspace reads and writes is in development.

Authentication

The CLI authenticates with a workspace link — a write link, or a read-only link — copied from the workspace page and stored locally by `sick login`.
The HTTP API will authenticate with an API token issued from your Sick & Nexra account; metered calls bill against your sick.cat plan.

The sick command line

Available

sick is a single file for Node 20 or later, with no install and no dependencies. It works on one workspace through that workspace’s link: list, pull and push files, read and set the workspace’s secrets and variables, attach GitHub repositories, and open a cloud sandbox’s terminal in your own.

A read-only link can read (whoami, ls, pull, cat, open); everything that changes the workspace or starts a sandbox needs the write link. Secret values are never printed back.

Install, verify and sign in

curl -fsSL https://sick.cat/cli/sick.mjs -o sick.mjs
node sick.mjs help

# put it on your PATH, then sign in with a workspace link
sick login <workspace link>
sick pull        # download the workspace here
sick push        # upload what changed
sick run         # start a sandbox and open its terminal

Full command reference at sick.cat/cli →

HTTP API

Coming soon

In development. Paths and fields below are provisional and may change before release.

A REST API will expose the same reads and writes the CLI performs, for scripting and integrations. It will be token-authenticated and versioned under /v1.

GET/v1/workspacesList the workspaces your token can reach.
GET/v1/workspaces/{id}/filesList a workspace’s files.
GET/v1/workspaces/{id}/files/{path}Read one file.
PUT/v1/workspaces/{id}/files/{path}Create or replace one file.
POST/v1/workspaces/{id}/sandboxesStart a sandbox.

← All API docs