docs: rewrite the README narrative with real examples and a hero demo - #21
Conversation
Codex Review SummaryThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
029de8b to
d8222e7
Compare
![greptile-apps[bot]](https://avatars.githubusercontent.com/in/867647?s=60&v=4){kind=small}
dc75651 to
e346bbd
Compare
e346bbd to
04d286f
Compare
![chatgpt-codex-connector[bot]](https://avatars.githubusercontent.com/in/1144995?s=60&v=4){kind=small}
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 04d286f678
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
04d286f to
2d1eada
Compare
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 2d1eada57a
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
aa40d70 to
fe146bf
Compare
oveddan
changed the title
db25d0a to
bede6cb
Compare
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: bede6cb1f8
ℹ️ About Codex in GitHub
Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you
- Open a pull request for review
- Mark a draft as ready
- Comment "@codex review".
If Codex has suggestions, it will comment; otherwise it will react with 👍.
Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".
66bb8f6 to
dce5652
Compare
"The problem" and "What this changes" are now Dan's own dictation, lightly edited and written without first person: four banks, on/off colors, toggle or tap, the open-source firmware, and why programming the Twister and its mappings by hand is slow. The DJ TechTools product page and firmware repo are linked. A new Examples section shows five exchanges adapted from real Chromatik sessions, each with the prompt and the agent's reply, trimmed. The first is an MPD218 mapping from RobotHeart moved onto the Twister. The last three are collapsed. The section says the Chromatik side goes through Chromatik's MCP server. The hero is a real demo, a split screen of a chat changing the knob colors, hosted on R2 because the source is over GitHub's 100 MB limit. The README shows a 4.7 MB GIF linking to a 3 MB MP4. Below "What this changes" is bank 1 of the Twister map artifact the agent keeps for the show, also on R2. The three missing image references are gone, and docs/images/README.md tracks the one image still wanted. "What this is not" is cut. The firmware attribution moved into Protocol coverage. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com> Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
dce5652 to
30dded9
Compare
1 participant
What changed
Narrative. "The problem" and "What this changes" are now my own dictation, lightly edited for grammar and verbal tics, and written without first person. They cover the four banks, on/off colors, toggle or tap, the open-source firmware, and why programming the Twister and its mappings by hand is slow. The DJ TechTools product page and the firmware repo are linked.
Examples. Five exchanges adapted from my Chromatik sessions, each showing the prompt and the agent's reply, trimmed. The prompts come from the session archive, rephrased as questions without first person. The first is my own MPD218 mapping from RobotHeart moved onto the Twister. The last three are collapsed so the install section stays close. The section says the Chromatik side goes through Chromatik's MCP server and the Twister side through this CLI. The examples are Chromatik-specific for now; generalizing them is a later pass.
Images. Main referenced four images that don't exist, so GitHub showed four broken-image icons.
docs/images/README.md."What this is not" is cut. The firmware attribution moved into Protocol coverage. The reference manual below is otherwise unchanged, and the README stays one file.
Still to come in this PR
Out of scope
🤖 Generated with Claude Code