Apps and Market
Install apps on your Cube from Market or from a GitHub repository, and keep them running.
An app is a program that opens in Cube. It lives on your machine, runs there whenever your machine is up, and fills Cube's window when you pick it in the sidebar, like Studio does. Kanban boards for your agents, agent workspaces, notes: anything with a web interface can be an app.
Under the hood an app is a git repository with a cube.json at its
root. Cube clones it onto your machine, runs it, and shows it in a tile.
Install from Market
Open Market in the sidebar to browse apps made for Cube. Search with Search apps, or open a card to read about the app, who made it, its license and how much space it takes.
Choose Install. Cube asks you to confirm first:
Install Paperclip on your Cube? An app can run a program on your Cube as you, with full access to it. Install only from authors you trust.
Once it's installed, the app appears in the sidebar under Studio and Market, and Open takes you to it.
Apps run as you
There's no sandbox: an app can read and change anything on your machine, like a program you run in a terminal. Install apps from people you trust.
Add an app from a GitHub repository
At the end of Market, choose Add app from repo and paste the address of a public GitHub
repository, such as https://github.com/owner/repo. Choose Check repository: Cube looks for a
valid cube.json at the root of its default branch, then asks you to confirm the install.
| Cube says | What it means |
|---|---|
| This repository is not public. | Only public repositories can be added this way. |
| The default branch needs a cube.json file at the repository root. | The repository isn't a Cube app yet. See Build an app. |
| The root cube.json is not a valid Cube app manifest. | cube.json is there but has a mistake. The reference lists the rules. |
Open and switch apps
Pick an app in the sidebar and it fills the window. Switching never stops anything: your terminals and agents keep running in Studio, and every app keeps running on your machine while you look at something else.
To jump between apps from the keyboard, hold ⌘ and tap `. See Find your way around.
While an app starts you'll see Installing…, Starting… or Loading…. If something goes wrong it says App stopped, App failed to start or Couldn't reach this app, with Retry.
Manage an app
Hover an app in the sidebar and choose ⋯ to open Manage app. It shows where the app came from, its version and its web address, and lets you:
| Action | Does |
|---|---|
| Start, Stop, Restart | Run or stop the app's program. |
| Update | Pull the latest version. Updates are never automatic; Market and Manage app show Update available. |
| View log | Show what the app printed, to see why it failed. |
| Customise | Copy the app into your repositories so you can change it. See Change an app. |
| Copy URL, Open in browser | The app's own web address, to open it outside Cube. |
| Remove | Stop the app and delete it from your machine. Data it kept elsewhere, such as in ~/.config, stays. |
Drag apps in the sidebar to put them in the order you like. The order follows you to the app switcher and your phone.
Where apps run
Apps run on your cloud machine, in ~/.cube/apps, separately from your repositories. Cube starts
them when your machine starts and restarts one that crashes. When you pause your
machine, its apps stop with it.
Each app also gets a private web address on cube.site, which is how
app.cube.computer and Open in browser reach it. Only you can open it: Cube signs
you in on the way.