sable GitHub →

Keyboard-first workspace manager · 0.4.2

Run your whole stack from one terminal.

Your dev server, database and scripts in one dashboard. Start them in your order and keep an eye on every log.

$npm install -g sable-workspaces

Needs Node.js 20 or newer. Works on Windows, macOS and Linux.

Try it before you install it.

A live copy of the dashboard with sample services. Click it, then try:

↑↓srSEnter?

sable · shopclick to use keys

You set the order. Sable keeps it.

Tell each item what to wait for. A service counts as ready after five seconds up, a command when it exits cleanly.

You press S0s
shop · 0 of 2 running

SERVICES
> db     ● running  
  api    ◌ after db

COMMANDS
  build  ● running
build finishes2s
shop · 1 of 2 running

SERVICES
> db     ● running  
  api    ◌ after db

COMMANDS
  build  ✓ done
db is ready5s
shop · 2 of 2 running

SERVICES
> db     ● running  
  api    ● running

COMMANDS
  build  ✓ done

Sharing

Read it before it runs.

Commit a sable.json and your whole team gets the same setup. When you open someone else's, Sable shows you every command before anything runs.

If the file changes later, you see exactly what changed first. Secrets stay on your machine, never in the file.

Review sable.json
This file will run these commands on your machine.
Nothing starts until you press Enter.

SERVICES
  db     docker compose up db
  api    npm run dev
         in api, after db
         PORT = {{API_PORT}}
         needs STRIPE_KEY on this machine
COMMANDS
  build  npm run build

--- since you agreed ---
- api  npm run dev
+ api  npm run dev -- --inspect
Entercreate workspace↑↓scrollEsccancel

Logs you can search.

Every line timestamped. Search, jump straight to the next error, or save logs to disk to read later.

api · shop · ● running · 214 lines · following

── service started · 09:41:07 ────────────────
09:41:07  listening on :3000
09:41:09  GET /products 200 11ms
09:41:12  POST /checkout 201 84ms
09:41:15  Error: payment provider timeout
09:41:15  retrying (1/3)
09:41:18  GET /cart 200 6ms
/searchenext errorwwrapEscback

It suggests what to run.

Point it at a project and it reads your package.json scripts, Makefile, Docker Compose, Cargo, Go and more. Tick what you want and you're set up.

Found in ~/code/shop

> [x] dev           npm run dev          
  [ ] build         npm run build
  [ ] test          npm test
  [x] compose up    docker compose up
  [ ] make migrate  make migrate
  [ ] cargo test    cargo test
↑↓moveSpacetickEnteradd

One key, one meaning, on every screen.

No cheat sheet needed. The footer shows the keys that work right now, and ? shows the rest.

  • aadda workspace or item
  • eediteverything in one form
  • ddeletealways asks first
  • mmovereorder the list
  • sstart / stopor run a command
  • rrestartor run again
  • Sstart allin your order
  • Enteropenlogs or workspace
  • Escbackone level, or q
  • ?helpon every screen
  • ,settingssound, tips, saved logs
  • Ctrl+Cquitand stop everything

Scope

What Sable isn't.

Sable stays small on purpose. It runs your project's services and scripts on your machine, and that's it.

  • ✕a task runnerIt runs what you already have. It doesn't define tasks or pipelines.
  • ✕tmuxNo panes or splits. One dashboard per project.
  • ✕an IDEKeep your editor. Sable sits next to it.
  • ✕a Docker managerIt can run docker compose up like any other command.
  • ✕an AI toolNo models, no prompts, no account.

Get it

Install and run.

Nothing to configure. Install once and use it in every project, on Windows, macOS or Linux.

~
$ npm install -g sable-workspaces
added 1 package
$ sable

  Sable 0.4.2
  Keyboard-first Workspace Manager
  ────────────────────────────────