
slinger
Teaches an agent to use the slinger canvas app through its CLI.
- GitHub stars
- 6
Install
/plugin install slinger@slingerRun it inside Claude Code after adding the marketplace with /plugin marketplace add jayminwest/slinger.
Contents
Discovered from sourceSkills 2
slinger-listen
The user slings from a canvas: a selection, the new ink and a prompt. While you listen, each sling of a workspace comes to this session in place of a process that slinger starts. You answer with your own tools and permissions.
-
Find the daemon. Run
slinger workspace list. It finds the running daemon on any socket. -
Find the workspace. If the user did not name one, take the one in the list whose directory holds the current directory. Ask only when none or more than one fits.
-
Take over from the hidden process. Run
slinger session show <WORKSPACE>. Withprocess running, slinger started a process for this agent that the user cannot see, and a sling can go to it while you do not listen. Stop it withslinger session stop <WORKSPACE>; do not ask. Only when itsstatusisworking, tell the user first: the stop ends its turn. -
Wait for a sling. Run this in the background, so the user can still talk to you, and act when it exits:
slinger session listen <WORKSPACE> --pid $PPID$PPIDis this session's process: if it ends while you work on a sling, slinger knows you are gone and keeps the sling for the next listener. It prints one sling and exits. The first line names your agent (agent=<NAME>); the second names the directory of the packet's images (at=<DIR>). -
Read the images you need: each
img=of the packet is a PNG inat=. The lines give only the place of the ink, the images give the words. -
Do what the prompt asks. Answer on the canvas, not in chat:
slinger canvas put <CANVAS> --beside <ITEM> --text "..." --agent <NAME>. Keep each text short. Runslinger guidefor the other verbs. -
Say that you are done:
slinger status set done --agent <NAME>, orslinger status set blocked --note "what you need" --agent <NAME>. Either ends your work on the sling. -
Go to step 4 at once, before you write anything to the user. Listen until the user tells you to stop.
Rules:
- A sling waits while you work: you get it when you listen again. Do not run two listeners for one workspace.
- To stop, end the background command. For 10 seconds after that slinger still counts you as listening: a sling sent then waits for the next listener. A sling sent later starts the agent's process, resuming its conversation, and goes to it.
- Exit code 6 means the daemon is not running. Tell the user; do not start it unless the user asks.
- Change only the items you made. Never change the user's ink.
slinger
Slinger is the user's canvas app: the user writes with a pen on a canvas and
agents answer with items on that canvas, not with chat. You use it through
the slinger CLI.
Run this first, and follow what it prints:
slinger guide
The guide comes from the installed slinger binary, so it always fits the
commands that binary has. Do not work from memory of an older guide. For one
command, run slinger <command> --help.
If you cannot run the guide, these rules hold:
slinger canvas listnames the canvases.slinger canvas read <CANVAS>prints what the user put on one, with the directory of its images.- Answer on the canvas:
slinger canvas put <CANVAS> --beside <ITEM> --text "..." --agent <NAME>. Leave out--agentwhenSLINGER_AGENTis set. - Change only the items you made. Never change the user's ink.
- Exit code 6 means no daemon
slingerdanswers. Tell the user; do not start it unless the user asks. - If
slingeris not installed:cargo install --locked --git https://github.com/jayminwest/slinger slinger.
Sponsors
Details
- Marketplace
- jayminwest/slinger
- Source
- plugin
- Category
- Community