hyperfocus

---

Hyperfocus restructures Claude's output so your brain can lock in. Not fewer words — better structure.

claude plugin marketplace add nextor2k/hyperfocus
claude plugin install hyperfocus@hyperfocus

Then type /hyperfocus in any conversation. Done.

---

What It Does

Hyperfocus changes how Claude talks to you.

Every response gets:

• Answer first — key point up top, context after
• Clear sections — subheadings you can scan in 2 seconds
• Short chunks — one idea per paragraph, short sentences
• Lists over walls — bullet points instead of dense prose

[!IMPORTANT] Same depth. Same technical accuracy. Just structured so your brain can absorb it.

---

Three Modes

Pick your level of structure. Switch anytime with /hyperfocus clean|flow|zen.

Clean

For: quick answers, PR summaries, terse professional prose.

Shorter paragraphs, front-loaded points, bullet lists. Professional tone stays intact.

Flow (default)

For: learning, debugging, technical explanations.

Each section follows What → Why → How. Subheadings every 2–3 paragraphs for easy re-entry after breaks.

Zen

For: dense docs, architecture discussions, long sessions.

TL;DR at the top of every response. Almost everything in lists or tables. Every section stands alone.

---

Before & After

This is what the same Claude response looks like without and with hyperfocus.

Without hyperfocus (default Claude):

The useMemo hook in React is used to memoize expensive computations so that they are only recalculated when their dependencies change. This is particularly useful when you have a component that re-renders frequently but has some computation that doesn't need to run on every render. Without useMemo, React would recalculate the value on every render, which could lead to performance issues. You should use it when you have computationally expensive operations that depend on specific props or state values, but be careful not to overuse it as the memoization itself has a small cost.

With hyperfocus — all three modes side by side:

useMemo caches expensive computations between re-renders. React only recalculates when dependencies change.

Use it when the computation is expensive and the component re-renders frequently. Don't overuse it — memoization itself has a small cost.

useMemo prevents unnecessary recalculation on re-renders.

What It Does

It caches a computed value. React only recalculates when dependencies change.

When To Use It

Use useMemo when:

• The computation is expensive (sorting, filtering, complex math)
• The component re-renders frequently
• The result depends on specific props or state

Watch Out

Don't overuse it. Memoization has a small cost. Only apply it where you can measure a difference.

TL;DR: useMemo caches expensive computations. Only recalculates when dependencies change.

What

• Caches a computed value between re-renders
• Recalculates only when dependencies change

When

• Expensive computations (sort, filter, math)
• Frequent re-renders
• Result depends on specific props/state

Caution

• Memoization has a small cost
• Only use where you can measure improvement

---

Install

Claude Code marketplace (recommended):

claude plugin marketplace add nextor2k/hyperfocus
claude plugin install hyperfocus@hyperfocus

When installed from the marketplace, the command appears as /hyperfocus:hyperfocus in the marketplace UI, but bare /hyperfocus usually works in your prompt.

Or install the skill directly:

npx skills add nextor2k/hyperfocus

Codex:

npx skills add nextor2k/hyperfocus -a codex

GitHub Copilot:

npx skills add nextor2k/hyperfocus -a github-copilot

Manual: Clone this repo. Copy skills/hyperfocus/ into your project's skills folder.

---

Usage

You can also say "focus mode", "adhd mode", or "adhd friendly" in your prompt to trigger activation.

---

Persistent Mode

Want hyperfocus on every session without typing /hyperfocus each time?

/hyperfocus persistent

This enables a plugin-owned SessionStart hook that re-injects the formatting rules at the start of every session. Your settings.json is never modified — hyperfocus stores its state in a dedicated plugin data directory.

How it works: When you install hyperfocus from the Claude Code marketplace, the plugin ships a SessionStart hook that reads your persistent state at session start and re-injects the rules automatically. Your state lives in the plugin's data directory (separate from your settings). Uninstalling the plugin removes its state entirely.

Note: Persistent mode requires a POSIX shell (sh) and is available on macOS, Linux, and WSL. Standalone skill installations (via npx skills) do not include persistent hooks.

Hyperfocus is a skill — formatting rules that load into Claude's context. No code, no build step. Code blocks, commits, and PRs stay untouched. Only prose gets restructured.

---

Capability Matrix

---

Migrating from Hyperfocus ≤0.2

If you're upgrading from an older version, you may need to clean up legacy configuration:

1. Remove old settings hook: If your ~/.claude/settings.json contains a UserPromptSubmit hook for hyperfocus-rules, delete it. The new version uses SessionStart instead.

2. Remove old rules file: If ~/.claude/hyperfocus-rules.txt exists, you can safely delete it. Rules are now managed by the plugin.

After upgrading, persistent mode will work automatically with the new hook. No manual configuration needed.

---

Supported Agents

• Claude Code — fully tested, mode persists all session
• Codex — supported, mode persists all session
• GitHub Copilot — supported via npx skills

[!WARNING] Some agents (Opencode, omp) may need re-activation each turn. That's an agent limitation, not