# All commands

URL: https://heaven.dev/docs/reference/commands
Updated: 2026-11-21

Heaven management commands run through the CLI, SSH, HTTP API and MCP.

For local commands such as `login` and `mcp`, use `heaven help COMMAND` or the [CLI guide](https://heaven.dev/docs/cli).

## Computers

| Command | Request |
| --- | --- |
| `heaven view [COMPUTER] [--pattern PATTERN] [--pool POOL] [--tag TAG] [--state on\|off ...] [--shared] [--limit N] [--after AFTER] [--group GROUP] [-l] [--organization ORGANIZATION] [--scope-pool SCOPE-POOL ...] [--scope-computer SCOPE-COMPUTER ...] [--scope-tag SCOPE-TAG ...]` | [List or read Computers](https://heaven.dev/docs/reference/computers/view) |
| `heaven usage [COMPUTER] [--range 24h\|7d\|30d] [--resolution 1m\|5m\|1h] [--points N] [--organization ORGANIZATION] [--pool POOL]` | [Read a Computer's usage](https://heaven.dev/docs/reference/computers/usage) |
| `heaven logs COMPUTER [--previous]` | [Read the boot console](https://heaven.dev/docs/reference/computers/logs) |
| `heaven create [NAME] [--pool POOL] [--image IMAGE] [--template NAME] [--registry-auth USER:PASSWORD] [--integration INTEGRATION ...] [--github REPO] [--setup-script SCRIPT] [--env KEY=VALUE ...] [--tag TAG ...] [--comment COMMENT] [--domain DOMAIN] [--cpu N] [--memory SIZE] [--disk SIZE] [--copy COMPUTER] [--snapshot SNAPSHOT] [--copy-tags true\|false] [--count N] [--names NAMES ...] [--new-pool] [--units N] [--hourly] [--monthly] [--dry-run] [--request-id ID] [--organization ORGANIZATION] [--wait[=DURATION]]` | [Create a Computer](https://heaven.dev/docs/reference/computers/create) |
| `heaven delete COMPUTER... [--request-id ID]` | [Delete Computers](https://heaven.dev/docs/reference/computers/delete) |
| `heaven start COMPUTER [--request-id ID] [--wait[=DURATION]]` | [Start a Computer](https://heaven.dev/docs/reference/computers/start) |
| `heaven stop COMPUTER [--request-id ID] [--wait[=DURATION]]` | [Stop a Computer](https://heaven.dev/docs/reference/computers/stop) |
| `heaven restart COMPUTER [--request-id ID] [--wait[=DURATION]]` | [Restart a Computer](https://heaven.dev/docs/reference/computers/restart) |
| `heaven pause COMPUTER [--request-id ID]` | [Pause a Computer](https://heaven.dev/docs/reference/computers/pause) |
| `heaven resume COMPUTER [--request-id ID]` | [Resume a Computer](https://heaven.dev/docs/reference/computers/resume) |
| `heaven reset COMPUTER [--image IMAGE] [--setup-script SCRIPT] [--request-id ID] [--dry-run] [--wait[=DURATION]]` | [Reinstall a Computer](https://heaven.dev/docs/reference/computers/reset) |
| `heaven rename COMPUTER NAME [--request-id ID]` | [Rename a Computer](https://heaven.dev/docs/reference/computers/rename) |
| `heaven move COMPUTER --pool POOL [--request-id ID] [--dry-run]` | [Move a Computer](https://heaven.dev/docs/reference/computers/move) |
| `heaven resize COMPUTER [--cpu N] [--memory SIZE] [--disk SIZE] [--request-id ID] [--wait[=DURATION]]` | [Resize a Computer](https://heaven.dev/docs/reference/computers/resize) |
| `heaven tag COMPUTER [TAGS...] [--remove REMOVE ...] [--request-id ID]` | [Tag a Computer](https://heaven.dev/docs/reference/computers/tag) |
| `heaven tag view [--prefix PREFIX] [--organization ORGANIZATION] [--limit N]` | [List tags](https://heaven.dev/docs/reference/computers/tag-view) |
| `heaven comment COMPUTER COMMENT [--request-id ID]` | [Comment on a Computer](https://heaven.dev/docs/reference/computers/comment) |
| `heaven terminal COMPUTER` | [Open the browser terminal](https://heaven.dev/docs/reference/computers/terminal) |
| `heaven desktop COMPUTER` | [Open the desktop](https://heaven.dev/docs/reference/computers/desktop) |
| `heaven access COMPUTER [--qr]` | [Read who has access](https://heaven.dev/docs/reference/computers/access) |
| `heaven share add COMPUTER [--user USER ...] [--team TEAM] [--whole-organization] [--role ROLE] [--command COMMAND ...] [--message MESSAGE]` | [Share a Computer](https://heaven.dev/docs/reference/computers/share-add) |
| `heaven share remove COMPUTER [--user USER ...] [--team TEAM] [--whole-organization] [--role ROLE]` | [Stop sharing a Computer](https://heaven.dev/docs/reference/computers/share-remove) |
| `heaven share link add COMPUTER [--label LABEL] [--expires DURATION] [--max-uses N] [--qr]` | [Create a share link](https://heaven.dev/docs/reference/computers/share-link-add) |
| `heaven share link remove COMPUTER LINK` | [Remove a share link](https://heaven.dev/docs/reference/computers/share-link-remove) |
| `heaven transfer COMPUTER [--user USER] [--team TEAM] [--whole-organization] [--keep-shares] [--pool POOL] [--request-id ID]` | [Transfer a Computer](https://heaven.dev/docs/reference/computers/transfer) |
| `heaven grant-support-root COMPUTER on\|off` | [Give support root access](https://heaven.dev/docs/reference/computers/grant-support-root) |
| `heaven website COMPUTER [--access ACCESS] [--public true\|false] [--port PORT]` | [Set who reaches the website](https://heaven.dev/docs/reference/computers/website) |
| `heaven port view [COMPUTER] [--organization ORGANIZATION]` | [List public ports](https://heaven.dev/docs/reference/computers/port-view) |
| `heaven port add COMPUTER GUEST-PORT` | [Publish a port](https://heaven.dev/docs/reference/computers/port-add) |
| `heaven port remove COMPUTER PORT` | [Close a port](https://heaven.dev/docs/reference/computers/port-remove) |
| `heaven mail view COMPUTER` | [Read mail settings](https://heaven.dev/docs/reference/computers/mail-view) |
| `heaven mail COMPUTER [on\|off] [--reply-policy REPLY-POLICY] [--dry-run]` | [Change mail settings](https://heaven.dev/docs/reference/computers/mail) |
| `heaven mail status COMPUTER MESSAGE` | [Read a message's delivery](https://heaven.dev/docs/reference/computers/mail-status) |

## Snapshots

| Command | Request |
| --- | --- |
| `heaven snapshot view [COMPUTER] [SNAPSHOT] [--sort SORT] [--limit N] [--after AFTER]` | [List or read snapshots](https://heaven.dev/docs/reference/snapshots/view) |
| `heaven snapshot create COMPUTER [NAME] [--note NOTE] [--expires DURATION] [--request-id ID]` | [Snapshot a Computer](https://heaven.dev/docs/reference/snapshots/create) |
| `heaven snapshot edit COMPUTER SNAPSHOT [--name NAME] [--note NOTE] [--expires DURATION] [--request-id ID]` | [Change a snapshot](https://heaven.dev/docs/reference/snapshots/edit) |
| `heaven snapshot restore COMPUTER SNAPSHOT [--request-id ID]` | [Restore a snapshot](https://heaven.dev/docs/reference/snapshots/restore) |
| `heaven snapshot delete COMPUTER SNAPSHOT... [--request-id ID]` | [Delete snapshots](https://heaven.dev/docs/reference/snapshots/delete) |

## Run and export

| Command | Request |
| --- | --- |
| `heaven exec COMPUTER [COMMAND...] [--download DOWNLOAD] [--upload UPLOAD] [--mode MODE]` | [Run a command](https://heaven.dev/docs/reference/exec/run) |
| `heaven export COMPUTER` | [Export a disk](https://heaven.dev/docs/reference/exec/export) |

## Templates

| Command | Request |
| --- | --- |
| `heaven template view [--organization ORGANIZATION]` | [List templates](https://heaven.dev/docs/reference/templates/view) |

## Pools

| Command | Request |
| --- | --- |
| `heaven pool view [POOL] [--part PART ...] [--organization ORGANIZATION]` | [List or read pools](https://heaven.dev/docs/reference/pools/view) |
| `heaven pool usage [POOL] [--range 24h\|7d\|30d] [--resolution 1m\|5m\|1h] [--points N] [--organization ORGANIZATION]` | [Read a pool's usage](https://heaven.dev/docs/reference/pools/usage) |
| `heaven pool create [NAME] [--buy PLAN] [--monthly] [--hourly] [--months MONTHS] [--offer OFFER] [--dry-run] [--memory SIZE] [--units N] [--server SERVER] [--copy POOL] [--snapshot SNAPSHOT] [--request-id ID] [--organization ORGANIZATION]` | [Create a pool](https://heaven.dev/docs/reference/pools/create) |
| `heaven pool delete POOL [--release] [--dry-run] [--request-id ID] [--organization ORGANIZATION]` | [Delete a pool](https://heaven.dev/docs/reference/pools/delete) |
| `heaven pool start POOL [--organization ORGANIZATION]` | [Start a pool](https://heaven.dev/docs/reference/pools/start) |
| `heaven pool stop POOL [--organization ORGANIZATION]` | [Stop a pool](https://heaven.dev/docs/reference/pools/stop) |
| `heaven pool pause POOL [--organization ORGANIZATION]` | [Pause a pool](https://heaven.dev/docs/reference/pools/pause) |
| `heaven pool resume POOL [--organization ORGANIZATION]` | [Resume a pool](https://heaven.dev/docs/reference/pools/resume) |
| `heaven pool stop-last POOL on\|off [--organization ORGANIZATION]` | [Keep a pool running longest](https://heaven.dev/docs/reference/pools/stop-last) |
| `heaven pool resize POOL [--memory SIZE] [--units N] [--buy PLAN] [--buy-rest monthly\|hourly] [--monthly] [--hourly] [--months MONTHS] [--offer OFFER] [--release] [--dry-run] [--request-id ID] [--organization ORGANIZATION]` | [Resize a pool](https://heaven.dev/docs/reference/pools/resize) |
| `heaven pool rename POOL NAME [--organization ORGANIZATION]` | [Rename a pool](https://heaven.dev/docs/reference/pools/rename) |
| `heaven pool split POOL [--name NAME] [--memory SIZE] [--computer COMPUTER ...] [--request-id ID] [--dry-run] [--organization ORGANIZATION]` | [Split a pool](https://heaven.dev/docs/reference/pools/split) |
| `heaven pool combine POOL WITH [--request-id ID] [--dry-run] [--organization ORGANIZATION]` | [Combine pools](https://heaven.dev/docs/reference/pools/combine) |
| `heaven pool transfer POOL [--to TO] [--request-id ID] [--dry-run] [--organization ORGANIZATION]` | [Transfer a pool](https://heaven.dev/docs/reference/pools/transfer) |
| `heaven pool defaults set POOL [--setup-script SCRIPT] [--cpu N] [--disk SIZE] [--domain DOMAIN] [--organization ORGANIZATION]` | [Set pool defaults](https://heaven.dev/docs/reference/pools/defaults-set) |
| `heaven pool defaults clear POOL [DEFAULT...] [--organization ORGANIZATION]` | [Clear pool defaults](https://heaven.dev/docs/reference/pools/defaults-clear) |
| `heaven pool share add POOL [--user USER ...] [--with-organization WITH-ORGANIZATION] [--team TEAM] [--role ROLE] [--command COMMAND ...] [--organization ORGANIZATION]` | [Share a pool](https://heaven.dev/docs/reference/pools/share-add) |
| `heaven pool share remove POOL [--user USER ...] [--with-organization WITH-ORGANIZATION] [--team TEAM] [--organization ORGANIZATION]` | [Stop sharing a pool](https://heaven.dev/docs/reference/pools/share-remove) |

## Pool snapshots

| Command | Request |
| --- | --- |
| `heaven pool snapshot view [POOL] [SNAPSHOT] [--shared true\|false] [--organization ORGANIZATION]` | [List or read pool snapshots](https://heaven.dev/docs/reference/pool-snapshots/view) |
| `heaven pool snapshot create POOL [NAME] [--note NOTE] [--expires DURATION] [--request-id ID] [--organization ORGANIZATION]` | [Snapshot a pool](https://heaven.dev/docs/reference/pool-snapshots/create) |
| `heaven pool snapshot edit POOL SNAPSHOT [--name NAME] [--note NOTE] [--expires DURATION] [--organization ORGANIZATION]` | [Change a pool snapshot](https://heaven.dev/docs/reference/pool-snapshots/edit) |
| `heaven pool snapshot restore POOL SNAPSHOT [--request-id ID] [--organization ORGANIZATION]` | [Restore a pool snapshot](https://heaven.dev/docs/reference/pool-snapshots/restore) |
| `heaven pool snapshot delete POOL SNAPSHOT [--request-id ID] [--organization ORGANIZATION]` | [Delete a pool snapshot](https://heaven.dev/docs/reference/pool-snapshots/delete) |
| `heaven pool snapshot share add POOL SNAPSHOT --user USER ... [--message MESSAGE] [--organization ORGANIZATION]` | [Share a pool snapshot](https://heaven.dev/docs/reference/pool-snapshots/share-add) |
| `heaven pool snapshot share remove POOL SNAPSHOT --user USER ... [--organization ORGANIZATION]` | [Stop sharing a pool snapshot](https://heaven.dev/docs/reference/pool-snapshots/share-remove) |

## Capacity

| Command | Request |
| --- | --- |
| `heaven capacity view [--organization ORGANIZATION]` | [Read your capacity](https://heaven.dev/docs/reference/capacity/view) |
| `heaven plan view` | [List plans](https://heaven.dev/docs/reference/capacity/plan-view) |
| `heaven capacity buy [--plan N] [--monthly] [--hourly] [--months MONTHS] [--offer OFFER] [--dry-run] [--server SERVER] [--request-id ID] [--organization ORGANIZATION]` | [Buy capacity](https://heaven.dev/docs/reference/capacity/buy) |
| `heaven capacity resize CAPACITY [--plan N] [--dry-run] [--organization ORGANIZATION]` | [Change a purchase's plan](https://heaven.dev/docs/reference/capacity/resize) |
| `heaven capacity switch CAPACITY [--monthly] [--hourly] [--dry-run] [--organization ORGANIZATION]` | [Switch monthly or hourly](https://heaven.dev/docs/reference/capacity/switch) |
| `heaven capacity cancel-change CAPACITY [--organization ORGANIZATION]` | [Cancel a scheduled change](https://heaven.dev/docs/reference/capacity/cancel-change) |
| `heaven capacity release CAPACITY [--dry-run] [--organization ORGANIZATION]` | [Release capacity](https://heaven.dev/docs/reference/capacity/release) |

## Domains

| Command | Request |
| --- | --- |
| `heaven domain view [COMPUTER] [--organization ORGANIZATION]` | [List domains and names](https://heaven.dev/docs/reference/domains/view) |
| `heaven domain connect DOMAIN [--who owners\|admins\|TEAM] [--organization ORGANIZATION]` | [Connect a domain](https://heaven.dev/docs/reference/domains/connect) |
| `heaven domain edit DOMAIN --who owners\|admins\|TEAM [--organization ORGANIZATION]` | [Change who adds names](https://heaven.dev/docs/reference/domains/edit) |
| `heaven domain address LABEL [--organization ORGANIZATION]` | [Choose the organization's address](https://heaven.dev/docs/reference/domains/address) |
| `heaven domain disconnect DOMAIN [--dry-run] [--organization ORGANIZATION]` | [Disconnect a domain](https://heaven.dev/docs/reference/domains/disconnect) |
| `heaven domain add COMPUTER DOMAIN [--port PORT] [--redirect URL] [--path PATH] [--strip-prefix]` | [Add a name to a Computer](https://heaven.dev/docs/reference/domains/add) |
| `heaven domain check DOMAIN [--organization ORGANIZATION] [--computer COMPUTER]` | [Check a name's DNS](https://heaven.dev/docs/reference/domains/check) |
| `heaven domain remove COMPUTER DOMAIN [--path PATH]` | [Remove a name](https://heaven.dev/docs/reference/domains/remove) |

## Static addresses

| Command | Request |
| --- | --- |
| `heaven ip view [--organization ORGANIZATION]` | [List static addresses](https://heaven.dev/docs/reference/addresses/view) |
| `heaven ip buy [--region REGION] [--count N] [--address ADDRESS] [--request-id ID] [--organization ORGANIZATION]` | [Buy static addresses](https://heaven.dev/docs/reference/addresses/buy) |
| `heaven ip attach [ADDRESS] [COMPUTER] [--pool POOL] [--account] [--server SERVER] [--attachment ATTACHMENT ...] [--organization ORGANIZATION]` | [Attach static addresses](https://heaven.dev/docs/reference/addresses/attach) |
| `heaven ip detach ADDRESS... [--computer COMPUTER] [--pool POOL] [--organization ORGANIZATION]` | [Detach static addresses](https://heaven.dev/docs/reference/addresses/detach) |
| `heaven ip release ADDRESS... [--dry-run] [--organization ORGANIZATION]` | [Release static addresses](https://heaven.dev/docs/reference/addresses/release) |

## Organizations

| Command | Request |
| --- | --- |
| `heaven organization view [--organization ORGANIZATION]` | [List or read organizations](https://heaven.dev/docs/reference/organizations/view) |
| `heaven organization usage [--organization ORGANIZATION]` | [Read an organization's usage](https://heaven.dev/docs/reference/organizations/usage) |
| `heaven audit view [--query QUERY] [--actor ACTOR] [--action ACTION] [--since SINCE] [--before BEFORE] [--limit N] [--format FORMAT] [--organization ORGANIZATION]` | [Read the audit log](https://heaven.dev/docs/reference/organizations/audit-view) |
| `heaven organization create NAME` | [Create an organization](https://heaven.dev/docs/reference/organizations/create) |
| `heaven organization delete [--dry-run] [--cancel] [--organization ORGANIZATION]` | [Close an organization](https://heaven.dev/docs/reference/organizations/delete) |
| `heaven organization rename NAME [--organization ORGANIZATION]` | [Rename an organization](https://heaven.dev/docs/reference/organizations/rename) |
| `heaven organization setting SETTING VALUE [--organization ORGANIZATION]` | [Change an organization's setting](https://heaven.dev/docs/reference/organizations/setting) |
| `heaven organization member view [--organization ORGANIZATION]` | [List members](https://heaven.dev/docs/reference/organizations/member-view) |
| `heaven organization member add USER [ROLE] [--grant GRANT ...] [--withhold WITHHOLD ...] [--team TEAM ...] [--organization ORGANIZATION]` | [Invite a member](https://heaven.dev/docs/reference/organizations/member-add) |
| `heaven organization member role USER [ROLE] [--grant GRANT ...] [--withhold WITHHOLD ...] [--organization ORGANIZATION]` | [Change a member's access](https://heaven.dev/docs/reference/organizations/member-role) |
| `heaven organization member remove USER [--transfer-computers-to USER] [--to-team TO-TEAM] [--to-organization] [--keep-shares] [--organization ORGANIZATION]` | [Remove a member](https://heaven.dev/docs/reference/organizations/member-remove) |
| `heaven organization leave [--transfer-computers-to USER] [--to-team TO-TEAM] [--to-organization] [--keep-shares] [--organization ORGANIZATION]` | [Leave an organization](https://heaven.dev/docs/reference/organizations/leave) |
| `heaven organization invitation view [--organization ORGANIZATION]` | [List sent invitations](https://heaven.dev/docs/reference/organizations/invitation-view) |
| `heaven organization invitation cancel INVITATION [--organization ORGANIZATION]` | [Cancel an invitation](https://heaven.dev/docs/reference/organizations/invitation-cancel) |
| `heaven organization link add [--role ROLE] [--organization ORGANIZATION]` | [Get a join link](https://heaven.dev/docs/reference/organizations/link-add) |
| `heaven organization link view [--organization ORGANIZATION]` | [List join links](https://heaven.dev/docs/reference/organizations/link-view) |
| `heaven organization link remove [--role ROLE] [--organization ORGANIZATION]` | [Remove a join link](https://heaven.dev/docs/reference/organizations/link-remove) |

## Teams

| Command | Request |
| --- | --- |
| `heaven organization team view [TEAM] [--organization ORGANIZATION]` | [List or read teams](https://heaven.dev/docs/reference/teams/view) |
| `heaven organization team create NAME [--user USER ...] [--organization ORGANIZATION]` | [Create a team](https://heaven.dev/docs/reference/teams/create) |
| `heaven organization team rename TEAM NAME [--organization ORGANIZATION]` | [Rename a team](https://heaven.dev/docs/reference/teams/rename) |
| `heaven organization team setting TEAM SETTING VALUE [--organization ORGANIZATION]` | [Change a team's setting](https://heaven.dev/docs/reference/teams/setting) |
| `heaven organization team member add TEAM USER [ROLE] [--organization ORGANIZATION]` | [Add a team member](https://heaven.dev/docs/reference/teams/member-add) |
| `heaven organization team member role TEAM USER ROLE [--organization ORGANIZATION]` | [Change a team member's role](https://heaven.dev/docs/reference/teams/member-role) |
| `heaven organization team member remove TEAM USER [--organization ORGANIZATION]` | [Remove a team member](https://heaven.dev/docs/reference/teams/member-remove) |
| `heaven organization team leave TEAM [--organization ORGANIZATION]` | [Leave a team](https://heaven.dev/docs/reference/teams/leave) |
| `heaven organization team delete TEAM [--organization ORGANIZATION]` | [Delete a team](https://heaven.dev/docs/reference/teams/delete) |

## Billing

| Command | Request |
| --- | --- |
| `heaven billing view [--organization ORGANIZATION]` | [Read billing](https://heaven.dev/docs/reference/billing/view) |
| `heaven billing cost [--organization ORGANIZATION]` | [Read this month's cost](https://heaven.dev/docs/reference/billing/cost) |
| `heaven billing history [--before BEFORE] [--limit N] [--organization ORGANIZATION]` | [List charges](https://heaven.dev/docs/reference/billing/history) |
| `heaven billing top-up [--amount DOLLARS] [--auto-top-up AUTO-TOP-UP] [--no-auto-top-up] [--invoice] [--organization ORGANIZATION]` | [Top up the wallet](https://heaven.dev/docs/reference/billing/top-up) |
| `heaven billing charge --amount DOLLARS [--request-id ID] [--organization ORGANIZATION]` | [Charge your saved card](https://heaven.dev/docs/reference/billing/charge) |
| `heaven billing auto-top-up [--amount DOLLARS] [--monthly-limit MONTHLY-LIMIT] [--off] [--organization ORGANIZATION]` | [Set automatic top-up](https://heaven.dev/docs/reference/billing/auto-top-up) |
| `heaven billing refund [--organization ORGANIZATION]` | [Refund the wallet](https://heaven.dev/docs/reference/billing/refund) |
| `heaven billing redeem CODE [--organization ORGANIZATION]` | [Redeem an offer](https://heaven.dev/docs/reference/billing/redeem) |
| `heaven billing invoices [--organization ORGANIZATION]` | [List invoices](https://heaven.dev/docs/reference/billing/invoices) |
| `heaven billing pay [INVOICE] [--organization ORGANIZATION]` | [Pay an invoice](https://heaven.dev/docs/reference/billing/pay) |
| `heaven billing details view [--organization ORGANIZATION]` | [Read invoice details](https://heaven.dev/docs/reference/billing/details-view) |
| `heaven billing details set [--organization ORGANIZATION] [--email EMAIL] [--company COMPANY] [--tax-id TAX-ID] [--postal-address LINE1] [--line2 LINE2] [--city CITY] [--state STATE] [--postal-code POSTAL-CODE] [--country COUNTRY]` | [Set invoice details](https://heaven.dev/docs/reference/billing/details-set) |
| `heaven billing card setup [--organization ORGANIZATION]` | [Start saving a card](https://heaven.dev/docs/reference/billing/card-setup) |
| `heaven billing card save SETUP [--organization ORGANIZATION]` | [Save a card](https://heaven.dev/docs/reference/billing/card-save) |
| `heaven billing portal [--organization ORGANIZATION]` | [Open the billing portal](https://heaven.dev/docs/reference/billing/portal) |
| `heaven billing egress-cap [--amount DOLLARS] [--off] [--default] [--organization ORGANIZATION]` | [Set the egress cap](https://heaven.dev/docs/reference/billing/egress-cap) |
| `heaven billing spend-alert [--amount DOLLARS] [--off] [--organization ORGANIZATION]` | [Set the spend alert](https://heaven.dev/docs/reference/billing/spend-alert) |
| `heaven billing spending-cap [--amount DOLLARS] [--off] [--organization ORGANIZATION]` | [Set the spending cap](https://heaven.dev/docs/reference/billing/spending-cap) |
| `heaven billing usage-emails [--on] [--off] [--organization ORGANIZATION]` | [Turn usage notices on or off](https://heaven.dev/docs/reference/billing/usage-emails) |
| `heaven billing contact view [--organization ORGANIZATION]` | [List billing contacts](https://heaven.dev/docs/reference/billing/contact-view) |
| `heaven billing contact add EMAIL [--organization ORGANIZATION]` | [Add a billing contact](https://heaven.dev/docs/reference/billing/contact-add) |
| `heaven billing contact remove EMAIL [--organization ORGANIZATION]` | [Remove a billing contact](https://heaven.dev/docs/reference/billing/contact-remove) |

## Integrations

| Command | Request |
| --- | --- |
| `heaven integration view [--organization ORGANIZATION]` | [List integrations](https://heaven.dev/docs/reference/integrations/view) |
| `heaven integration create KIND [--name NAME] [--target TARGET] [--header HEADER ...] [--bearer BEARER] [--basic-auth BASIC-AUTH] [--strip-prefix STRIP-PREFIX] [--attachment ATTACHMENT ...] [--comment COMMENT] [--peer] [--no-auth] [--read-only true\|false] [--organization ORGANIZATION]` | [Create an integration](https://heaven.dev/docs/reference/integrations/create) |
| `heaven integration edit INTEGRATION [--target TARGET] [--header HEADER ...] [--remove-header REMOVE-HEADER ...] [--bearer BEARER] [--basic-auth BASIC-AUTH] [--strip-prefix STRIP-PREFIX] [--attachment ATTACHMENT ...] [--comment COMMENT] [--peer] [--no-auth] [--read-only true\|false] [--reconnect] [--organization ORGANIZATION]` | [Change an integration](https://heaven.dev/docs/reference/integrations/edit) |
| `heaven integration attach INTEGRATION ATTACHMENT... [--organization ORGANIZATION]` | [Attach an integration](https://heaven.dev/docs/reference/integrations/attach) |
| `heaven integration detach INTEGRATION [ATTACHMENT...] [--all] [--organization ORGANIZATION]` | [Detach an integration](https://heaven.dev/docs/reference/integrations/detach) |
| `heaven integration rename INTEGRATION NAME [--organization ORGANIZATION]` | [Rename an integration](https://heaven.dev/docs/reference/integrations/rename) |
| `heaven integration pause INTEGRATION [--organization ORGANIZATION]` | [Pause an integration](https://heaven.dev/docs/reference/integrations/pause) |
| `heaven integration resume INTEGRATION [--organization ORGANIZATION]` | [Resume an integration](https://heaven.dev/docs/reference/integrations/resume) |
| `heaven integration delete INTEGRATION [--organization ORGANIZATION]` | [Delete an integration](https://heaven.dev/docs/reference/integrations/delete) |
| `heaven integration repo view INTEGRATION [--organization ORGANIZATION]` | [List a GitHub integration's repositories](https://heaven.dev/docs/reference/integrations/repo-view) |

## Account

| Command | Request |
| --- | --- |
| `heaven account view [--organization ORGANIZATION]` | [Read your account](https://heaven.dev/docs/reference/account/view) |
| `heaven account email EMAIL [--code CODE] [--old-code OLD-CODE]` | [Change your email address](https://heaven.dev/docs/reference/account/email) |
| `heaven account name [NAME] [--clear]` | [Set your name](https://heaven.dev/docs/reference/account/name) |
| `heaven account delete [--transfer-computers-to USER] [--code CODE]` | [Delete your account](https://heaven.dev/docs/reference/account/delete) |
| `heaven notification view` | [List notifications](https://heaven.dev/docs/reference/account/notification-view) |
| `heaven notification read [NOTIFICATION] [--all]` | [Mark notifications read](https://heaven.dev/docs/reference/account/notification-read) |
| `heaven defaults view` | [Read your default setup script](https://heaven.dev/docs/reference/account/defaults-view) |
| `heaven defaults set --setup-script SCRIPT` | [Set your default setup script](https://heaven.dev/docs/reference/account/defaults-set) |
| `heaven defaults clear` | [Clear your default setup script](https://heaven.dev/docs/reference/account/defaults-clear) |
| `heaven sign-in view` | [Read your sign-ins](https://heaven.dev/docs/reference/account/sign-in-view) |
| `heaven sign-in lifetime LIFETIME` | [Set your sign-in lifetime](https://heaven.dev/docs/reference/account/sign-in-lifetime) |
| `heaven sign-in end-all` | [Sign out everywhere](https://heaven.dev/docs/reference/account/sign-in-end-all) |
| `heaven mcp-request view REQUEST` | [Read an MCP sign-in request](https://heaven.dev/docs/reference/account/mcp-request-view) |
| `heaven invitation view` | [List your invitations](https://heaven.dev/docs/reference/account/invitation-view) |
| `heaven invitation accept INVITATION` | [Accept an invitation](https://heaven.dev/docs/reference/account/invitation-accept) |
| `heaven invitation decline INVITATION` | [Decline an invitation](https://heaven.dev/docs/reference/account/invitation-decline) |

## SSH keys

| Command | Request |
| --- | --- |
| `heaven ssh-key view` | [List SSH keys](https://heaven.dev/docs/reference/ssh-keys/view) |
| `heaven ssh-key add [PUBLIC-KEY] [--label LABEL] [--tag TAG] [--computer COMPUTER]` | [Add an SSH key](https://heaven.dev/docs/reference/ssh-keys/add) |
| `heaven ssh-key rename KEY LABEL` | [Rename an SSH key](https://heaven.dev/docs/reference/ssh-keys/rename) |
| `heaven ssh-key remove KEY` | [Remove an SSH key](https://heaven.dev/docs/reference/ssh-keys/remove) |

## API keys

| Command | Request |
| --- | --- |
| `heaven api-key view [--all]` | [List API keys](https://heaven.dev/docs/reference/api-keys/view) |
| `heaven api-key create [--label LABEL] [--expires DURATION] [--command COMMAND ...] [--scope-pool SCOPE-POOL ...] [--scope-computer SCOPE-COMPUTER ...] [--scope-tag SCOPE-TAG ...] [--organization ORGANIZATION]` | [Create an API key](https://heaven.dev/docs/reference/api-keys/create) |
| `heaven api-key edit KEY [--label LABEL] [--expires DURATION] [--command COMMAND ...] [--scope-pool SCOPE-POOL ...] [--scope-computer SCOPE-COMPUTER ...] [--scope-tag SCOPE-TAG ...] [--no-scope]` | [Change an API key](https://heaven.dev/docs/reference/api-keys/edit) |
| `heaven api-key rotate KEY [--overlap OVERLAP]` | [Rotate an API key](https://heaven.dev/docs/reference/api-keys/rotate) |
| `heaven api-key remove KEY` | [Remove an API key](https://heaven.dev/docs/reference/api-keys/remove) |

## Connect codes

| Command | Request |
| --- | --- |
| `heaven connect-code create [--organization ORGANIZATION]` | [Create a connect code](https://heaven.dev/docs/reference/connect-codes/create) |
| `heaven connect-code view` | [List agents waiting for approval](https://heaven.dev/docs/reference/connect-codes/view) |
| `heaven connect-code approve REQUEST` | [Approve an agent](https://heaven.dev/docs/reference/connect-codes/approve) |
| `heaven connect-code deny REQUEST` | [Deny an agent](https://heaven.dev/docs/reference/connect-codes/deny) |

## Operations

| Command | Request |
| --- | --- |
| `heaven operation view OPERATION [--wait] [--timeout DURATION]` | [Read an operation](https://heaven.dev/docs/reference/operations/read) |

## Key permissions

| Command | Request |
| --- | --- |
| `heaven command view [COMMAND] [--full true\|false]` | [List the commands a key can run](https://heaven.dev/docs/reference/command/view) |

## Feedback

| Command | Request |
| --- | --- |
| `heaven feedback TEXT [--computer COMPUTER] [--request-id ID]` | [Send feedback](https://heaven.dev/docs/reference/feedback/send) |
