Skip to main content
A CLI is a program an agent runs in the workspace shell, such as gh issue list or pdftotext report.pdf -. Account CLIs carry their own credentials and need no mount; git, office, pdfinfo and pdftotext work on the files in the workspace’s mounts. The host mirage CLI is a different program: it connects to a workspace from outside.

Example: gh

workspace.yaml
  • A CLI never reads a mount’s credentials, and mounting a service does not install its CLI. One token can serve both.
  • gh --help lists a program’s groups, gh issue list --help its flags and man gh its manual.

Supported CLIs

Files

Developer

Chat

Productivity

Every command of every CLI is listed in the Python and TypeScript references.

Add your own

Compatibility and licenses

Each CLI reference links the original project or service API and defines the implemented subset. Compatibility covers the documented commands, flags, output and behavior; it does not promise every upstream feature. Git also names its actual runtime dependencies: Dulwich in Python and isomorphic-git in TypeScript. Mirage-authored code is Apache-2.0 licensed. Behavioral compatibility does not change the license of any project’s code. Copied or ported source and redistributed dependencies must satisfy their own license and notice requirements. The Python notices and the TypeScript notices of core and node cover incorporated third-party code; installed libraries also include their own license files. A compatibility claim is not a substitute for checking source provenance and the contents of a distribution.