adapt is the command-line client for Adapt Platform.
Use it to manage agent infrastructure like sandboxes, MCP connections, and more.
On macOS or Linux, run:
curl -fsSL https://platform.adapt.com/install.sh | shThe 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.
Start the login process:
adapt auth loginThe CLI shows a code and opens an approval page in your browser.
- Sign in to Adapt Platform in the browser.
- Make sure that the browser code matches the CLI code.
- Approve access.
- If the CLI asks for an organization, select one.
Show your account and selected organization:
adapt whoamiIf the machine has no browser, use adapt auth login --no-browser.
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.comTo use a profile for every command in your shell, set ADAPT_PROFILE:
export ADAPT_PROFILE=staging
adapt whoamiThe --profile option overrides ADAPT_PROFILE.
List saved profiles with adapt profiles.
For more information, see the CLI reference.
Open a shell:
adapt sandbox shOr run a command:
adapt sandbox sh --image ubuntu:24.04 -- uname -aThe 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 that stays available after each command:
adapt sandbox create --image ubuntu:24.04 --cpu 2 --memory 2048 --waitIn the examples below, replace SANDBOX_ID with the ID from the response.
Run a command in the sandbox:
adapt exec SANDBOX_ID -- uname -aOpen an interactive shell:
adapt exec SANDBOX_ID -it -- /bin/shPress Ctrl-] to disconnect from this shell. The remote execution continues after you disconnect.
List all sandboxes:
adapt sandbox list --allDelete the sandbox when you no longer need it:
adapt sandbox delete SANDBOX_IDResource commands accept a full ID or a unique ID prefix.
Upload a file to a sandbox:
adapt files put SANDBOX_ID ./input.txt /tmp/input.txtDownload a file from a sandbox:
adapt files get SANDBOX_ID /tmp/output.txt ./output.txtFind 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_NAMEPut the required arguments in arguments.json.
Then call the tool:
adapt connections call CONNECTION_ID TOOL_NAME --arguments @arguments.jsonInstall the Adapt skill for Codex, Claude Code, Pi, and OpenCode:
adapt skill installTo install it for one agent, add the agent name. For example:
adapt skill install codexShow the skill text without installing:
adapt skill showShow the commands and their options:
adapt --help
adapt sandbox --help
adapt sandbox create --helpTo install from this repository, use a current stable Rust toolchain:
cargo install --path . --lockedRun 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'