Terminal UI for viewing and monitoring Cloudflare Workers (and related tools) from your terminal
Install via the shell script:
curl -fsSL https://raw.githubusercontent.com/NWBY/cftop/refs/heads/main/install.sh | sh
To upgrade to the latest version you can simply run the install command above.
To use cftop you will need two things:
- Your account ID
- A user API token with the following permissions:
- Account Analytics:Read
- D1:Read
- Workers Agents Configuration:Read
- Workers Observability:Edit
- Workers Observability:Read
- Workers R2 Storage:Read
- Workers Tail:Read
- Workers Scripts:Read
- Workers KV Storage:Read
Once you've got your account ID and API token you need to initialise the config file:
cftop init --apiToken=<api-token> --accountId=<acccount-id>
If you want to be able to view the contents of a R2 bucket then you will need to create an R2 API token which has read access to all your buckets and pass in the Access Key ID and Secret Access Key like this:
cftop init --apiToken=<api-token> --accountId=<acccount-id> --accessKey=<access-key-id> --secretKey=<secret-access-key>
Once initialisation is complete you can run: cftop
| Key | Action |
|---|---|
q |
Quit cftop |
h |
Go to the home view (default view) |
w |
Focus on the workers box |
d |
Focus on the durable objects box |
b |
Focus on the R2 buckets box |
tab |
Switch focus to next box |
up |
Select previous item in list |
down |
Select next item in list |
enter |
Select to view details (only for viewing Worker and R2 details) |