idapt CLI

Your AI workspace, from the terminal.

Manage workspaces, agents, files, chats, computers, and more — all from your terminal. Pipe JSON, script triggers, or just work faster without leaving the command line.

Install

npm i -g @idapt/cli

View on GitHub Get Started

Quick Start

Install the CLI

Terminal

npm i -g @idapt/cli

Or download from GitHub Releases

Authenticate

Terminal

idapt login

Opens your browser (device-code on headless machines). Or create an API key in the app, or set the IDAPT_API_KEY environment variable.

Start using it

Terminal

$ idapt workspace list
$ idapt chat send my-chat --content "Hello"
$ idapt drive upload --file ./report.pdf
$ idapt upgrade                 # keep it current

Features

Everything you can do in the browser, now from the command line.

200+ AI Models

Access every model from your terminal

Agents & Chat

Create agents and have conversations

Computers

Pair, exec, and manage connected computers

Drive & Search

Upload, download, grep, and glob

Tasks & Boards

Create, assign, and track tasks

Cloud Code Run

Sandboxed Python and Node.js in the cloud

Hub

Install skills and agents

Image & Audio

Generate images and transcribe audio

Web Search

Search the web and fetch pages

Subagent

Orchestrate agent conversations

Commands

Resource, execution, discovery, account, and system command groups — each follows a consistent verb pattern.

Resources

workspaceWorkspaces and membership

list, create, get, update, delete, members, invite

agentAgents

list, create, get, update, delete, move, copy-to-workspace

chatChats and messaging

list, create, get, send, reprompt, messages, runs, cost, export, stop

driveDrive files

list, read, upload, update, delete, create-folder, move, glob, grep, content-versions

notesWorkspace notes

box-list, list, read, write, search-all, graph, tree, folder-*

memoryShared agent memory

list, read, write, delete, search, index-read

tasksTask tracker

list, create, get, update, assign, comment, depend + labels

computerCloud and paired computers

list, create, run, exec, terminal, fs, ports, port-open, apps, add-exposure

credentialOutbound credentials

list, create, get, update, delete, versions

skillReusable instruction bundles

list, create, fork, install, publish, render, search

automationScheduled and triggered runs

list, create, fire, test-fire, runs, retry-run, cost-stats

integrationOutbound MCP and OpenAPI tools

list, add, connect, test, tools, call, catalog

Execution

inferenceDirect model calls across every modality

text, image, video, speech, transcribe

webWeb search and fetch

search, fetch

operationAsync operation handles

await, get, list, cancel, content

hookCondition to injection pairs

list, create, toggle, override, preview, history

Discovery

searchSearch across your workspace

query

modelsModel catalog

list, search

image / audio / videoPer-modality model and voice catalogs

models, search, voices

shareResource sharing

list, create, update, delete

notificationNotifications and preferences

list, get, read-all, preferences, update-preferences

Account

authNamed credential contexts

list, switch, rename, remove

configCLI configuration

get, set, unset, list, path, edit

settingsAccount settings

get, update

meYour profile and usage

get, usage

api-keyAPI keys

list, create, update, delete, rotate

System

login / logout / whoamiSign in and show the effective identity

--device, --api-key-stdin, --context

workspace use / current / clearPin the workspace commands run in

<ref>, -

upgrade / updateSelf-update to the latest release

--check, --next

help / instructionsCommand contract and resource playbook

<resource> [verb]

versionVersion, Node, platform, config path, API URL

(print version)

Examples

Sign in & explore

Terminal

$ idapt login                  # browser OAuth (device-code fallback)
✓ Signed in as [email protected]

$ idapt workspace list -o table
NAME          SLUG          ROLE
My Workspace    my-workspace    owner
Team Alpha    team-alpha    editor

Agents & chat

Terminal

$ idapt agent create --name "Code Reviewer" \
    --system-prompt "You review code for bugs and style."

$ idapt chat send code-review --content "Review this PR diff" \
    -w my-workspace

$ idapt chat messages code-review -o json | jq '.[-1].text'

Drive & search

Terminal

$ idapt drive upload --file ./report.pdf -w my-workspace
$ idapt drive grep "TODO" -w my-workspace

Computers

Terminal

$ idapt computer exec prod-server "docker ps"
$ idapt computer download prod-server --path /var/log/app.log
$ idapt computer terminal create prod-server --name deploy

I/O Formats

Every command supports 4 output formats. Input via named flags, --json, or stdin.

tableHuman-readable columns (default for TTY)

$ idapt workspace list
NAME          SLUG          ROLE
My Workspace    my-workspace    owner

jsonComputer-readable JSON (default when piped)

$ idapt workspace list -o json
[{"name":"My Workspace","slug":"my-workspace","role":"owner"}]

jsonlOne JSON object per line

$ idapt workspace list -o jsonl
{"name":"My Workspace","slug":"my-workspace","role":"owner"}

quietIDs only

$ idapt workspace list -o quiet
proj_abc123

Global Flags

Flag	Description
--api-key	API key for authentication (or IDAPT_API_KEY env)
--api-url	API base URL (default https://idapt.app)
--workspace	Default workspace slug (or IDAPT_WORKSPACE env)
-o, --output	Format: table \| json \| jsonl \| quiet
-y, --yes	Skip confirmation prompts
--no-color	Disable color output

Links

GitHub Repository Connect a computer Documentation Get Started

Quick Start

Install the CLI

Terminal

npm i -g @idapt/cli

Or download from GitHub Releases

Authenticate

Terminal

idapt login

Opens your browser (device-code on headless machines). Or create an API key in the app, or set the IDAPT_API_KEY environment variable.

Start using it

Terminal

$ idapt workspace list
$ idapt chat send my-chat --content "Hello"
$ idapt drive upload --file ./report.pdf
$ idapt upgrade                 # keep it current

Features

Everything you can do in the browser, now from the command line.

200+ AI Models

Access every model from your terminal

Agents & Chat

Create agents and have conversations

Computers

Pair, exec, and manage connected computers

Drive & Search

Upload, download, grep, and glob

Tasks & Boards

Create, assign, and track tasks

Cloud Code Run

Sandboxed Python and Node.js in the cloud

Hub

Install skills and agents

Image & Audio

Generate images and transcribe audio

Web Search

Search the web and fetch pages

Subagent

Orchestrate agent conversations

Commands

Resource, execution, discovery, account, and system command groups — each follows a consistent verb pattern.

Resources

workspaceWorkspaces and membership

list, create, get, update, delete, members, invite

agentAgents

list, create, get, update, delete, move, copy-to-workspace

chatChats and messaging

list, create, get, send, reprompt, messages, runs, cost, export, stop

driveDrive files

list, read, upload, update, delete, create-folder, move, glob, grep, content-versions

notesWorkspace notes

box-list, list, read, write, search-all, graph, tree, folder-*

memoryShared agent memory

list, read, write, delete, search, index-read

tasksTask tracker

list, create, get, update, assign, comment, depend + labels

computerCloud and paired computers

list, create, run, exec, terminal, fs, ports, port-open, apps, add-exposure

credentialOutbound credentials

list, create, get, update, delete, versions

skillReusable instruction bundles

list, create, fork, install, publish, render, search

automationScheduled and triggered runs

list, create, fire, test-fire, runs, retry-run, cost-stats

integrationOutbound MCP and OpenAPI tools

list, add, connect, test, tools, call, catalog

Execution

inferenceDirect model calls across every modality

text, image, video, speech, transcribe

webWeb search and fetch

search, fetch

operationAsync operation handles

await, get, list, cancel, content

hookCondition to injection pairs

list, create, toggle, override, preview, history

Discovery

searchSearch across your workspace

query

modelsModel catalog

list, search

image / audio / videoPer-modality model and voice catalogs

models, search, voices

shareResource sharing

list, create, update, delete

notificationNotifications and preferences

list, get, read-all, preferences, update-preferences

Account

authNamed credential contexts

list, switch, rename, remove

configCLI configuration

get, set, unset, list, path, edit

settingsAccount settings

get, update

meYour profile and usage

get, usage

api-keyAPI keys

list, create, update, delete, rotate

System

login / logout / whoamiSign in and show the effective identity

--device, --api-key-stdin, --context

workspace use / current / clearPin the workspace commands run in

<ref>, -

upgrade / updateSelf-update to the latest release

--check, --next

help / instructionsCommand contract and resource playbook

<resource> [verb]

versionVersion, Node, platform, config path, API URL

(print version)

Examples

Sign in & explore

Terminal

$ idapt login                  # browser OAuth (device-code fallback)
✓ Signed in as [email protected]

$ idapt workspace list -o table
NAME          SLUG          ROLE
My Workspace    my-workspace    owner
Team Alpha    team-alpha    editor

Agents & chat

Terminal

$ idapt agent create --name "Code Reviewer" \
    --system-prompt "You review code for bugs and style."

$ idapt chat send code-review --content "Review this PR diff" \
    -w my-workspace

$ idapt chat messages code-review -o json | jq '.[-1].text'

Drive & search

Terminal

$ idapt drive upload --file ./report.pdf -w my-workspace
$ idapt drive grep "TODO" -w my-workspace

Computers

Terminal

$ idapt computer exec prod-server "docker ps"
$ idapt computer download prod-server --path /var/log/app.log
$ idapt computer terminal create prod-server --name deploy

I/O Formats

Every command supports 4 output formats. Input via named flags, --json, or stdin.

tableHuman-readable columns (default for TTY)

$ idapt workspace list
NAME          SLUG          ROLE
My Workspace    my-workspace    owner

jsonComputer-readable JSON (default when piped)

$ idapt workspace list -o json
[{"name":"My Workspace","slug":"my-workspace","role":"owner"}]

jsonlOne JSON object per line

$ idapt workspace list -o jsonl
{"name":"My Workspace","slug":"my-workspace","role":"owner"}

quietIDs only

$ idapt workspace list -o quiet
proj_abc123

Global Flags

Flag	Description
--api-key	API key for authentication (or IDAPT_API_KEY env)
--api-url	API base URL (default https://idapt.app)
--workspace	Default workspace slug (or IDAPT_WORKSPACE env)
-o, --output	Format: table \| json \| jsonl \| quiet
-y, --yes	Skip confirmation prompts
--no-color	Disable color output

idapt CLI

##Quick Start

##Features

##Commands

Resources

Execution

Discovery

Account

System

##Examples

###Sign in & explore

###Agents & chat

###Drive & search

###Computers

##I/O Formats

###Global Flags

##Links

idapt CLI

##Quick Start

##Features

##Commands

Resources

Execution

Discovery

Account

System

##Examples

###Sign in & explore

###Agents & chat

###Drive & search

###Computers

##I/O Formats

###Global Flags

##Links

Quick Start

Features

Commands

Examples

Sign in & explore

Agents & chat

Drive & search

Computers

I/O Formats

Global Flags

Links

Quick Start

Features

Commands

Examples

Sign in & explore

Agents & chat

Drive & search

Computers

I/O Formats

Global Flags

Links