envctl is one binary: the CLI, and envd, the agent that makes your machine a sandbox.
Commands
| Command | What it does |
|---|---|
envctl login | Store the API’s address and a token |
envctl templates | List the templates you can lease |
envctl sandbox | Make this machine the sandbox, stop it, or show it |
envctl env | Create, list and delete environments |
envctl exec | Run a command in an environment |
envctl sync, status, logs | Sync now, show shares and peers, show connections |
envctl snapshots | List a project’s snapshots |
envctl artifact | Store, fetch, list, link and delete artifacts |
envctl project | List project keys, or shred one |
envctl skills | Install or print the envlink skill for coding agents |
envctl version | Print envctl’s version |
envctl <command> -h prints a command’s flags.
Environment variables
| Variable | Used for |
|---|---|
ENVLINK_API | The API’s address; overrides what login stored |
ENVLINK_TOKEN | A CLI token; overrides what login stored |
ENVLINK_INSTALL_DIR | Where install.sh puts envctl |
ENVLINK_SOCKET | The local envd’s socket, for status, sync and logs inside an environment |
Files
| Path | What it is |
|---|---|
~/.envlink/credentials.json | The API’s address and your token, mode 0600 |
~/.envlink/sandbox/ | The sandbox’s envd: configuration, tailnet identity, project keyring, logs, socket |
.remote/<environment>/<share>/ | Results from an environment’s out shares, in the sandbox’s folder |
Exit codes
| Code | Meaning |
|---|---|
0 | Success |
1 | Something went wrong: the message says what |
2 | The command line was wrong |
| Any other | envctl exec passes the remote command’s code through; 124 means --timeout stopped it |