Commands

alineo list

List the agent specs saved in the current project's agents directory.

bunx alineo-cli list

Reads alineo.config.json for agentsDir (defaults to ./agents), lists every .json file there, and prints a table. It does not query the OpenSandbox server or check whether any sandbox exists for a spec — it only reads local files.

Example output

NAME                  CLI       DESCRIPTION
node-toolchain        pi        A Node.js sandbox with TypeScript tooling.
python-data-sci        pi        A Python sandbox for data science work.
ColumnDescription
NAMEThe spec's name field, or the filename (without .json) as a fallback. Truncated to 19 characters.
HARNESSThe spec's harness field (currently always "pi"). Truncated to 7 characters.
DESCRIPTIONThe spec's description field, falling back to title, or blank if neither is set.

A spec file that fails to parse as JSON is still listed, with (unreadable) in place of its columns, instead of being silently skipped.

Notes

  • list only reflects what's in agentsDir on disk — a spec appearing here does not mean it has ever been Alineo.start()ed or has a sandbox snapshot yet.
  • If agentsDir doesn't exist, list prints No agents dir found at '<dir>'. Run 'alineo add <url>' to add an agent spec. and exits cleanly.
  • If agentsDir exists but is empty, list prints No agent specs found. Run 'alineo add <url>' to add one. and exits cleanly.

alineo add

Fetch an agent spec from a URL or local file and save it to your project's agents directory.

alineo remove

Delete a saved agent spec file from the current project.

On this page

Example outputNotes