Getting Started
Introduction
desk is a small command-line tool that gives quick experiments and one-off clones a named home, out of your way.
What is desk?#
Most local work is planned: your main projects live where you put them. The rest is not. You try a library in an empty folder, clone a repository to check one thing, fix a typo in a project you do not usually work on. Those directories pile up as test-2, tmp-fix, and a third clone of the same repo.
desk gives that in-between work a home. desk new creates a workspace with a memorable name such as misty-ember and takes you there. Your prompt shows which workspace you're in, desk cd jumps between them, and desk rm deletes one when you're done.
Quick Start#
Installation
Build the desk binary and add shell integration.
Quickstart
Create, move between, and delete workspaces in two minutes.
Commands
Six commands, each on one page.
Core Ideas#
Workspaces
Plain directories with two-word names: empty, or a Git clone.
Shell integration
desk cd, a prompt that shows where you are, and completion for zsh, bash, and fish.
What desk Is Not#
desk manages directories, not development environments. It does not install toolchains, run containers, or sync anything. It also deliberately leaves out, for now:
- automatic cleanup, and anything that runs in the background;
git pullor resets when you return to a repository;- editor and Amp integrations;
- Windows support.
desk is early and deliberately minimal. It runs on macOS and Linux, and it is installed by building from source.