i-have-dyslexia

Dyslexia-friendly output from any AI coding agent. One file. Any harness.

A dyslexia port of i-have-adhd by Ayoub G. (@ayghri). Same idea, different reader. Dyslexia is a decoding difference, not an attention one. So these rules shape structure, never substance. Full credit in Credits.

The one rule

Never simplify content. Only change how it is structured and presented.

What changes

Before

The issue you're seeing is most likely related to the way tokens are validated in the middleware layer, specifically in the verifyToken function in src/auth.ts around lines 42 to 58, which appears to be using an outdated version of the jsonwebtoken API, so I'd recommend updating the package to the latest version and then rewriting the function to match the new API, after which you should run the auth tests to confirm nothing else breaks.

After

Token validation is the bug. The fix is 3 steps.

1. Update the package: npm install jsonwebtoken@latest
2. Rewrite verifyToken in src/auth.ts:42-58
3. Run the tests: npm test -- auth.spec.ts

Cause: verifyToken uses the old jsonwebtoken API. v9 changed the signature.

Next: run step 1 now.

Same facts. Different shape. Try the interactive toggle: demo.html (open in a browser, or serve with GitHub Pages).

The rules

10 rules. Full text in i-have-dyslexia.md.

1. Headline first.
2. Short sentences. One idea per sentence.
3. Bold the key term in every line.
4. Never simplify the content.
5. Number every process.
6. Blank line between ideas.
7. Same shape every time.
8. Bullets over paragraphs.
9. Plain glue words, exact content words.
10. Visual formats beat prose.

Plus dyslexia fit: say "dyslexia fit" to your agent and it interviews you — 7 questions, bold defaults — then writes a ## My profile block that overrides any rule. The interview script lives inside the rules file, so every harness below gets it for free.

Plus share mode: say "share this" and the last answer becomes a self-contained HTML page — inline CSS, expandable detail sections, readable defaults. Send it to anyone.

Plus glossary keeper: the agent decodes each technical term once, records it in .dyslexia-glossary.json, and never makes you decode it twice. Say "glossary" to review your terms.

Plus escape hatch: say "explain it" and the agent drops brevity for the current topic — full depth, structure kept. Say "back to normal" to return.

Plus presets: switch output mode mid-session — "compact" for narrow terminals, "classroom" for learning, "presentation" for sharing. Say "default" to switch back.

Install

One command. Detects your harness. Installs the full rules locally. Adds a managed instruction that points to them:

curl -sSL https://raw.githubusercontent.com/mdeloughry/i-have-dyslexia/main/install.sh | sh

Or pick your harness by hand. The rules live in one file: i-have-dyslexia.md.

Step-by-step per harness: INSTALL.md

Display setup

The rules fix what the agent writes. DISPLAY.md fixes how your screen shows it — fonts, spacing, contrast, terminal and editor settings.

Tune it

Easy way: load the rules, then say "dyslexia fit". The agent asks 7 questions and writes your profile for you.

Manual way: create i-have-dyslexia.profile.md beside the rules. Start with i-have-dyslexia.profile.example.md. Keeping preferences separate means future rule updates cannot overwrite them.

## My profile

- Mixed dyslexia profile.
- For reports: give me interactive HTML with expandable sections, not dense prose.
- Prefer diagrams over text explanations.

Credits

• i-have-adhd by @ayghri — the idea and the format.
• British Dyslexia Association style guidance, adapted for LLM output.

License

MIT.