CLI

tanvrit-compute

The CLI is the primary interface for submitting jobs, managing agents, and switching workspaces. Versioned semver — breaking flags trigger a major version bump and a deprecation note 90 days ahead.

Install

macOS / Linux

curl -L https://compute.tanvrit.com/install.sh | sh

Ready

Homebrew

brew install tanvrit/tap/compute

Phase 2

Windows MSI / Linux DEB

# .msi and .deb at
# artifacts.tanvrit.com/compute/<ver>

Phase 2

Global flags

Flag	Description
--json	Emit machine-readable JSON instead of human output.
--verbose / -v	Verbose tracing (HTTP requests, retries).
--workspace <name>	Override the active workspace for one command.
--target <local\|cloud>	Pin the control-plane target. Default: local.
--no-color	Disable ANSI colour codes.
--version	Print CLI version and exit.

Auth

auth login

Browser device-code OAuth flow; caches token in OS keychain.

input

tanvrit-compute auth login

output

Open https://compute.tanvrit.com/auth/device?code=BX-9K2-PQM ...
Logged in as you@example.com

auth print-token

Print the current bearer token (use for scripting; rotates with refresh).

input

tanvrit-compute auth print-token

output

tnv_pat_01jt5...redacted

auth logout

Forget the cached token; agent stops accepting work.

input

tanvrit-compute auth logout

output

Logged out. Token removed from keychain.

Jobs

jobs run <file>

Submit a Job manifest (YAML or JSON).

input

tanvrit-compute jobs run hello-world.yaml

output

● Submitted   job_01jt9hello
✓ SUCCESS    0.42s · exit 0

jobs status <id>

Print state, exit code, runtime, and assigned agent.

input

tanvrit-compute jobs status job_01jt9hello

output

state: SUCCEEDED · exit 0 · runtime 0.42s · agent local-01

jobs logs <id> [--follow]

Tail the log buffer; --follow streams live via SSE.

input

tanvrit-compute jobs logs job_01jt9hello --follow

output

hello from tanvrit-compute
[stream closed]

jobs cancel <id>

Send SIGTERM, then SIGKILL after grace period (default 30s).

input

tanvrit-compute jobs cancel job_01jt9hello

output

Cancelling job_01jt9hello ... cancelled (state: CANCELLED)

jobs list [--state=...]

List recent jobs in the active workspace; filter by state.

input

tanvrit-compute jobs list --state=running --json

output

[{"id":"job_01jt...","state":"RUNNING","agent":"local-01"}]

Agents

agents list

Show registered agents in the active workspace.

input

tanvrit-compute agents list

output

ID         STATE    LABELS
local-01   ONLINE   os=darwin,arch=arm64

agents install

Install the desktop agent as a launchd / systemd / Windows service.

input

tanvrit-compute agents install --auto-start

output

Installed agent service (launchd com.tanvrit.compute.agent).
Started. State: ONLINE.

agent run

Run an agent in the foreground (useful for development and Steps 1-5 of the quickstart).

input

tanvrit-compute agent run --workspace local

output

agent: ready — listening for jobs

Workspaces

workspaces create <name>

Create a new workspace; you become its owner.

input

tanvrit-compute workspaces create acme-prod

output

Created workspace acme-prod (ws_01jt...). You are owner.

workspaces switch <name>

Set the active workspace for subsequent commands.

input

tanvrit-compute workspaces switch acme-prod

output

Active workspace: acme-prod

workspaces list

Show all workspaces you have access to.

input

tanvrit-compute workspaces list --json

output

[{"id":"ws_01jt...","name":"local","role":"owner"}]

Config

config edit

Open ~/.tanvrit/compute.yaml in $EDITOR.

input

tanvrit-compute config edit

output

(opens $EDITOR with the active config)

config get <key>

Print a single config value (dot notation).

input

tanvrit-compute config get default.workspace

output

local

Versioning

The CLI is versioned semver. Breaking flags trigger a major version bump and a deprecation note 90 days ahead. Output formats stable inside a major version. JSON output (--json) is the contract for scripting; human-formatted text is best-effort. See changelog.