Get started

Quickstart

Install the Tracee CLI, sign in from your browser and publish a post.

You need a Tracee workspace with at least one connected channel, and Node.js 18.17 or newer.

Install the CLI
Tracee serves the CLI itself, as one file with no dependencies.
```
npm install -g https://traceeai.com/cli/tracee-cli.tgz
```
To run it once without installing: npx https://traceeai.com/cli/tracee-cli.tgz whoami.
Sign in
```
tracee login
```
Your browser opens Tracee. Press Allow, and the CLI receives a personal key named after this computer. If you're in several workspaces, it asks which one to use.
On a server or over SSH, use tracee login --no-browser and paste the code the page shows. In CI, use a workspace key.

Check it

tracee whoami

Output

Workspace      Acme (2023180e-b03b-4ac1-94ab-0eae79d5cb63)
Acting as      API · Tracee CLI · laptop · dana@acme.com
Tracee         https://traceeai.com
Requests left  119 of 120 a minute

Publish a post

tracee channels
tracee posts create \
  --body "Our new dashboard is live." \
  --channel linkedin \
  --link https://acme.com/launch \
  --publish now

If your workspace requires approval to publish, the answer is Sent for approval and the post goes out once a person approves it in Tracee.

The same thing over HTTP

curl https://traceeai.com/api/v1/posts \
  -H "Authorization: Bearer $TRACEE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "body": "Our new dashboard is live.",
    "channels": ["<channel_id>"],
    "linkUrl": "https://acme.com/launch",
    "publish": "now"
  }'

Next steps

Authentication

Personal keys, workspace keys and OAuth.

CLI reference

Every command and flag.

API reference

Every endpoint, with a playground.