@idapt/cli

The idapt CLI — drive your idapt AI workspace from the terminal or any script: agents, chats, files (Drive), 200+ models, cloud computers, secrets, triggers, sharing, and more — all over the public v1 API.

It's also the library that powers the idapt command, so you can embed the exact same idapt <resource> <verb> grammar in your own tools.

Install

npm install -g @idapt/cli      # provides the `idapt` command
# or run without installing:
npx @idapt/cli idapt agent list

Quick start

# Authenticate (create an API key in the app: Settings → API keys)
export IDAPT_API_KEY=uk_...

idapt agent list                                   # list your agents
idapt chat create --title "Hello"                  # start a chat
idapt drive list                                   # browse your Drive
idapt model list                                   # 200+ available models

Output is a human table on a TTY and JSON when piped; force it with -o json|jsonl|quiet. Every command self-documents:

idapt help <resource> <verb>          # arguments, types, defaults
idapt instructions <resource>         # when/why playbook

Use as a library

import { execute, createFetchTransport } from "@idapt/cli";

const transport = createFetchTransport({
  baseUrl: "https://idapt.app",
  token: process.env.IDAPT_API_KEY,
});

const r = await execute("idapt drive list --parent-id folder_x", {
  transport,
  mode: "table", // "json" | "jsonl" | "quiet" | "table" | "llm"
});
console.log(r.ok ? r.rendered : r.error);

For a fully typed, method-per-endpoint client, see @idapt/sdk.

Links

• CLI overview & docs
• Command reference
• Public API reference

License

Apache-2.0 — see LICENSE, NOTICE, and THIRD_PARTY_NOTICES.txt.