Tokenspace CLI

CLI for creating, linking, syncing, and publishing Tokenspace workspaces.

Installation

bun add -g tokenspace

Requirements

• Bun >=1.3.9

Authentication

The CLI uses WorkOS Device Authorization Flow for secure authentication. This allows you to authenticate via your browser without storing long-lived credentials.

Login

tokenspace login
tokenspace login --url=http://localhost:31337

The CLI discovers the active WorkOS client ID and Convex deployment from the selected web app, then remembers that target in ~/.tokenspace/auth.json for future commands and generated links.

Check authentication status

tokenspace whoami

Logout

tokenspace logout

Usage

Initialize a workspace

tokenspace init my-workspace --name "My Workspace"

tokenspace init now scaffolds the workspace first, then offers to:

• install the capability-authoring skill for Claude Code plus standards-compatible agents with bunx skills add https://github.com/tokenspace-ai/skills --skill capability-authoring --agent claude-code -y
• run git init && git add . && git commit -m "init tokenspace"
• run bun install

Use --yes to accept all three by default, or control them individually:

tokenspace init my-workspace --yes
tokenspace init my-workspace --skip-install-skill --skip-git-init --skip-bun-install
tokenspace init my-workspace --install-skill --git-init --bun-install

Link a local workspace

tokenspace link
tokenspace link my-workspace
tokenspace link --create --name "My Workspace" --slug my-workspace

This writes .tokenspace/link.json in the current directory and ensures .tokenspace/ is gitignored.

Pull workspace files

tokenspace pull
tokenspace pull --dry-run

Push local files and a revision

tokenspace push
tokenspace push --dry-run
tokenspace push --open

tokenspace push syncs local source files to the linked tokenspace's default branch working state, builds build/tokenspace, pushes a revision, and prints the revision playground URL.

Compile locally

tokenspace compile
tokenspace compile --out-dir build/tokenspace

Environment

tokenspace login is self-configuring. To authenticate against a local web app during development, pass the app URL explicitly:

tokenspace login --url=http://localhost:31337