The slipdock CLI
A command-line client that wraps the whole API. It keeps the token for you, reads better in a transcript than raw curl, and does a few things nothing else does.
Use it when the agent works in a terminal on your machine, or you want what only the CLI has: syncing your wiki to a folder, files over 10 MB, imports and exports.
How it works
slipdock
is a command-line client for everything the API does: boards, cards, comments,
the wiki, files (slipdock attach
and slipdock download), search,
automations and runners. It saves the server's
address and your token, so neither you nor the agent has to repeat them, and its
output is easier to read in a transcript than raw JSON.
It's an Elixir escript, so the machine that runs it needs Erlang/OTP. That's why nothing else on this page depends on it.
Every command
The
command reference
lists every command by group, with a filter to find one by name. It is made from the
same text slipdock help
prints, so it never falls behind the CLI, and is easier to search than a terminal.
Install it
On Linux and macOS, into ~/.local/bin/slipdock. It needs Erlang/OTP 27 or later,
and if there is none it says what to install (brew install erlang
on a Mac) rather than running anything as root. It checks the download against
/cli/SHA256SUMS
and the release key's signature (with ssh-keygen):
curl -fsSL https://app.slipdock.us/cli/install.sh | sh
slipdock auth
That is /cli/install.sh, the CLI; /install.sh
without /cli/
installs the skills.
On Windows, in PowerShell. This installs Erlang through winget if it isn't already there:
irm https://app.slipdock.us/cli/install.ps1 | iex
slipdock auth
A server built from source serves no signature, and with none (or no ssh-keygen
to check it) both install nothing and say why. To install its CLI on the checksum alone, add | sh -s -- --allow-unsigned, or on Windows set
$env:SLIPDOCK_ALLOW_UNSIGNED = '1'
first.
From a checkout, build it from the repository (Elixir 1.17 or later):
cd cli && mix escript.build && cp slipdock ~/.local/bin/
slipdock url https://app.slipdock.us
slipdock auth
slipdock auth
uses the same sign-in as the guide: it prints a code and you approve it in the browser.
slipdock url
with no argument shows which server it's pointing at, which is the first thing to
check when it can't connect.
What it has that MCP doesn't
-
slipdock syncmirrors your wiki to a local folder and keeps the two in step, so you can edit pages in Obsidian or any other editor;slipdock sync from-serverandslipdock sync to-serverrun a pass one way only. -
slipdock attachuploads files up to 250 MB, recordings included, where MCP takes up to 10 MB. - Importing and exporting boards and pages, including from Trello.
-
slipdock skills installandslipdock skills checkkeep the skills up to date, andslipdock tools installandslipdock tools checkdo the same for a Tool's skills. -
slipdock tools publishpacks a folder and publishes it as a Tool.
Good to know
-
$SLIPDOCK_URLand$SLIPDOCK_TOKENoverride the saved address and token for a single command, such as one run against another server. -
slipdock guideprints the short agent guide, which ends with the names of its other sections;slipdock guide wikiprints one of them, andslipdock guide allthe whole guide, which is long. -
slipdock worklists what is waiting on you, andslipdock cardon an epic andslipdock boardprint aWaiting on you:line for what in the tree is on you (waiting_on_meonget_cardandget_board:count,cardswith their reasons,on_othersandline); an epic whose tree is all waiting on a person has nothing workable;slipdock waitandslipdock answeropen and answer a wait on a person (--questiononce per question,--answeronce per answer,--skipto move on without them,--kindthe kind of question, which the board routes to its person;slipdock waitslists the ones asked before);slipdock pulsegives a board's flow numbers;slipdock pauseandslipdock resumehold and release its runner work. -
The skills
use the CLI where it's installed and fall back to
curlwhere it isn't.