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, get, create, update, delete, archive, unarchive, members, add-member, update-member, remove-member, invitations, invite, revoke-invitation

agentAgents

list, get, create, update, delete, archive, unarchive, restore, permanent-delete, move, copy-to-workspace

chatChats and messaging

list, get, create, update, delete, archive, unarchive, restore, permanent-delete, messages, send, retry, runs, cost, message-costs, trigger-compaction, compact, set-goal, goal, end-goal, resume-goal, stop, export, import, copy-to-agent, copy-to-workspace, fork-to-workspace

chat-filesA chat's own file tree, outside Drive

list, read, write, edit, glob, grep, move, delete, create-folder, usage, purge-machine, download

chat-filesA chat's own file tree, outside Drive

list, read, write, edit, glob, grep, move, delete, create-folder, usage, purge-machine, download

driveDrive files

list, read, download, get-metadata, upload, update, delete, restore, permanent-delete, create-folder, move, signed-url, content-versions, restore-version, glob, grep

knowledgeThe workspace Knowledge Base (your agents' persistent memory)

list, read, write, delete, search, links, versions, version-read, version-restore, tag-list, tag-rename, note-rename, edit, note-move, tree, folder-list, folder-create, folder-rename, folder-move, folder-delete, import, trash-list, restore, purge, trash-empty, grep, find, replace, index-sync, prune, active-chats, working-set

computerCloud and paired computers

list, get, ephemeral, run, update, delete, allow, update-allowance, revoke, transfer, local-inference, local-models, add-local-model, remove-local-model, local-inference-map, local-inference-operations, local-inference-cancel, start, stop, rotate-credential, exec, terminal, download, upload, download-to-drive, fs, ports, port-label, users, create-user, get-user, update-user, delete-user, activity, manage, port-open, port-close, port-make-public, port-revoke-public

containerWorkspace Docker and Compose workloads

list, get, create, compose-up, run, update, delete, up, down, restart, rebuild, compose-get, compose-set, logs, exec, ports, port-open, port-close, port-make-public, port-revoke-public, backup, restore, backups, migrate, events, runtime

credentialOutbound credentials

list, get, create, update, delete, allow, connect, versions

credential-bindingCredential bindings

list, create

connectionsGit repository connections (clone, branches, MRs)

git-repos, git-repo, git-devcontainer, git-branches, git-open-mr

skill-packSkill packs

list, create, import, get, update, delete, restore, check-updates, refresh, unlink, skills, files, file-read, file-write, file-move, file-delete

skillReusable instruction bundles

search, get, body, render

automationScheduled and event-triggered Actions

list, cost-stats-all, get, create, update, delete, archive, unarchive, test-fire, cost-stats, runs, runs-all, cancel-run, retry-run, rotate-secret

httpOutbound HTTP requests

request

mcpOutbound MCP servers

info, tools, call, prompts, prompt, resources, resource

serviceOutbound service directory

search, lookup

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, get, create, update, delete, toggle, override, history, preview

ai-gatewayProvider routing and gateway usage

providers, usage, route-preview

realtimeRealtime channels

broadcast, presence, presence-list

Discovery

searchSearch across your workspace

query

modelsModel catalog

list, get, search

imageImage models

models, search

audioAudio models and voices

voices, models, search-models, search-voices

videoVideo models

models, search

shareResource sharing

list, create, update, delete

shared-with-meResources shared with you

list

notificationNotifications and preferences

list, preferences, update-preferences, config, update-config, get, send, update, delete, read-all

help-centerHelp center articles

list, search, read

guideIn-app guides

get

recommended-actionRecommended actions

list, create, update, complete, dismiss, delete

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, limits

teamTeam billing and usage

subscription, storage, usage

api-keyAPI keys

list, create, update, delete, rotate

custom-modelsWorkspace custom models

list, create, get, update, delete

provider-endpointProvider endpoints

list, presets, create, update, delete, test

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, get, create, update, delete, archive, unarchive, members, add-member, update-member, remove-member, invitations, invite, revoke-invitation

agentAgents

list, get, create, update, delete, archive, unarchive, restore, permanent-delete, move, copy-to-workspace

chatChats and messaging

chat-filesA chat's own file tree, outside Drive

list, read, write, edit, glob, grep, move, delete, create-folder, usage, purge-machine, download

chat-filesA chat's own file tree, outside Drive

list, read, write, edit, glob, grep, move, delete, create-folder, usage, purge-machine, download

driveDrive files

list, read, download, get-metadata, upload, update, delete, restore, permanent-delete, create-folder, move, signed-url, content-versions, restore-version, glob, grep

knowledgeThe workspace Knowledge Base (your agents' persistent memory)

computerCloud and paired computers

containerWorkspace Docker and Compose workloads

credentialOutbound credentials

list, get, create, update, delete, allow, connect, versions

credential-bindingCredential bindings

list, create

connectionsGit repository connections (clone, branches, MRs)

git-repos, git-repo, git-devcontainer, git-branches, git-open-mr

skill-packSkill packs

list, create, import, get, update, delete, restore, check-updates, refresh, unlink, skills, files, file-read, file-write, file-move, file-delete

skillReusable instruction bundles

search, get, body, render

automationScheduled and event-triggered Actions

list, cost-stats-all, get, create, update, delete, archive, unarchive, test-fire, cost-stats, runs, runs-all, cancel-run, retry-run, rotate-secret

httpOutbound HTTP requests

request

mcpOutbound MCP servers

info, tools, call, prompts, prompt, resources, resource

serviceOutbound service directory

search, lookup

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, get, create, update, delete, toggle, override, history, preview

ai-gatewayProvider routing and gateway usage

providers, usage, route-preview

realtimeRealtime channels

broadcast, presence, presence-list

Discovery

searchSearch across your workspace

query

modelsModel catalog

list, get, search

imageImage models

models, search

audioAudio models and voices

voices, models, search-models, search-voices

videoVideo models

models, search

shareResource sharing

list, create, update, delete

shared-with-meResources shared with you

list

notificationNotifications and preferences

list, preferences, update-preferences, config, update-config, get, send, update, delete, read-all

help-centerHelp center articles

list, search, read

guideIn-app guides

get

recommended-actionRecommended actions

list, create, update, complete, dismiss, delete

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, limits

teamTeam billing and usage

subscription, storage, usage

api-keyAPI keys

list, create, update, delete, rotate

custom-modelsWorkspace custom models

list, create, get, update, delete

provider-endpointProvider endpoints

list, presets, create, update, delete, test

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