Skip to content

About

No description, website, or topics provided.

Resources

Stars

5 stars

Watchers

0 watching

Forks

Latest commit

 

History

54 Commits

Folders and files

Repository files navigation

Adapt Platform CLI

adapt is the command-line client for Adapt Platform. Use it to manage agent infrastructure like sandboxes, MCP connections, and more.

Install

On macOS or Linux, run:

curl -fsSL https://platform.adapt.com/install.sh | sh

The installer verifies the SHA-256 checksum and places adapt in ~/.local/bin. Add ~/.local/bin to your PATH and restart your shell.

To update the CLI, run the same install command.

To change the install directory, set ADAPT_INSTALL_DIR on the sh command.

Sign in

Start the login process:

adapt auth login

The CLI shows a code and opens an approval page in your browser.

  1. Sign in to Adapt Platform in the browser.
  2. Make sure that the browser code matches the CLI code.
  3. Approve access.
  4. If the CLI asks for an organization, select one.

Show your account and selected organization:

adapt whoami

If the machine has no browser, use adapt auth login --no-browser.

Profiles

A profile stores an API URL, credentials, and a selected organization. The default profile is default.

Sign in to another profile with --profile:

adapt --profile staging auth login --api-url https://platform.adaptstaging.com

To use a profile for every command in your shell, set ADAPT_PROFILE:

export ADAPT_PROFILE=staging
adapt whoami

The --profile option overrides ADAPT_PROFILE. List saved profiles with adapt profiles. For more information, see the CLI reference.

Use a temporary sandbox

Open a shell:

adapt sandbox sh

Or run a command:

adapt sandbox sh --image ubuntu:24.04 -- uname -a

The CLI creates a sandbox and waits for it to run. It deletes the sandbox and its disk when the shell or command ends.

Sandboxes expire after one hour by default. Use --ttl SECONDS to change this time. Use --no-expiry to disable automatic expiry.

Create a sandbox

Create a sandbox that stays available after each command:

adapt sandbox create --image ubuntu:24.04 --cpu 2 --memory 2048 --wait

In the examples below, replace SANDBOX_ID with the ID from the response.

Run a command in the sandbox:

adapt exec SANDBOX_ID -- uname -a

Open an interactive shell:

adapt exec SANDBOX_ID -it -- /bin/sh

Press Ctrl-] to disconnect from this shell. The remote execution continues after you disconnect.

List all sandboxes:

adapt sandbox list --all

Delete the sandbox when you no longer need it:

adapt sandbox delete SANDBOX_ID

Resource commands accept a full ID or a unique ID prefix.

Transfer files

Upload a file to a sandbox:

adapt files put SANDBOX_ID ./input.txt /tmp/input.txt

Download a file from a sandbox:

adapt files get SANDBOX_ID /tmp/output.txt ./output.txt

Call connected tools

Find tools on your connected Model Context Protocol (MCP) services:

adapt connections search "files"

In the following commands, use the CONNECTION_ID and TOOL_NAME from the search results. Show the input schema for a tool from the results:

adapt connections describe CONNECTION_ID TOOL_NAME

Put the required arguments in arguments.json. Then call the tool:

adapt connections call CONNECTION_ID TOOL_NAME --arguments @arguments.json

Install the Skill

Install the Adapt skill for Codex, Claude Code, Pi, and OpenCode:

adapt skill install

To install it for one agent, add the agent name. For example:

adapt skill install codex

Show the skill text without installing:

adapt skill show

Help

Show the commands and their options:

adapt --help
adapt sandbox --help
adapt sandbox create --help

Build and test

To install from this repository, use a current stable Rust toolchain:

cargo install --path . --locked

Run the development checks:

cargo fmt --all -- --check
cargo clippy --locked --all-targets -- -D warnings
cargo test --locked
cargo build --locked --release
python3 -m unittest discover -s scripts -p '*_test.py'

License

MIT License.

About

No description, website, or topics provided.

Resources

Stars

5 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages