docs: reframe README around the terminal-console positioning#289
Merged
Conversation
Lead with what run-kit *is* — an agent-agnostic, tmux-native, phone-first remote console — rather than what rk riff does. The previous opening was feature-led and never stated the category, leaving run-kit indistinguishable from agent-wrapper dashboards. - Rewrite tagline + 'Why run-kit?' to lead with the console framing and the agent-agnostic stance (the agent is one of the things you run, not the thing run-kit is — so it outlives whichever agent you run). - Add a 'What run-kit is (and isn't)' table making the is/isn't explicit. - Thread the 'a pane is just a pane' framing through the body (riff intro, spawn_command note, serve/architecture wording, command table). All reference sections (status dots, boards, push, commands) unchanged.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Reframes the README opening to lead with what run-kit is — an agent-agnostic, tmux-native, phone-first remote console — instead of what
rk riffdoes.Why
The previous opening was feature-led ("
rk riffspawns AI coding agents in parallel git worktrees…"). It never stated the category, which left run-kit indistinguishable from the crowded field of agent-wrapper dashboards. The durable truth is that run-kit is a terminal layer, not an agent wrapper — a coding agent is just one of the things you run in a pane (equally a build, a REPL, an ssh session). That's what makes it outlive whichever agent tooling is current.Changes
spawn_commandnote, serve/architecture wording, and the command table.Positioning is implicit throughout — no competitor is named. Net
+24 / -14on a single file.