Docs Index feature for your Cursor

Alexey Elizarov — Sun, 01 Feb 2026 18:23:27 +0000

Is your Cursor agent losing track of your project?

The bigger your codebase, the more often the agent goes "out of context": it forgets where things are, mixes up modules, or suggests outdated solutions. Cursor doesn’t have a built-in mechanism to keep project architecture context up to date — so I added one.

cursor-docs-hook — a rule + hook in a single package.

Rule: tells the agent to create and use docs/INDEX.md and module-level INDEX.md files as a project map — read them to get an overview of structure, module purposes, and where to find things. One entry point instead of scattered files.
Hook: tracks which files Cursor changed during a run. When Cursor finishes and changes were made, the hook runs cursor-agent in the background and updates docs/INDEX.md and module-level INDEX.md. The context the agent reads and maintains stays in sync with the code, so it doesn’t lose orientation as the project grows.

One command installs both rule and hook together:

npx cursor-hook install beautyfree/cursor-docs-hook

If you use Cursor in growing projects — give it a try.

👉 https://github.com/beautyfree/cursor-docs-hook

P.S. Your GitHub stars and sharing among Cursor users is a great way to say thanks✨

Focus Restore feature for your Cursor

Alexey Elizarov — Thu, 22 Jan 2026 19:39:14 +0000

When working with Cursor agents, I noticed a small but recurring productivity leak.

While the agent is running, it’s very easy to switch context — read a website, check Telegram, do something else.
The problem appears when the agent finishes: Cursor doesn’t automatically regain window focus, and I often return to it with a delay.

This breaks the flow.

To solve this, I built a small utility hook that automatically brings the Cursor window back into focus once the agent finishes its work.

What it does
• Listens for agent completion
• Activates the Cursor window automatically
• Helps you immediately continue working without context switching friction

Key points
• Cross-platform (macOS, Windows, Linux)
• Lightweight and minimal
• Designed specifically as a UX improvement for agent-based workflows
• Easy to install and remove

Why this matters
When you use agents frequently, even small delays add up.
This hook doesn’t try to be “smart” — it just removes a tiny but annoying interruption in the feedback loop between you and the agent.

Sometimes that’s all you need.

Repository
👉 https://github.com/beautyfree/cursor-window-activate-hook

For simple try:

npx cursor-hook install beautyfree/cursor-window-activate-hook

If you’re using Cursor agents heavily and notice the same issue — feel free to try it out or adapt it to your workflow.

Feedback and improvements are welcome.

DEV Community: Alexey Elizarov

Docs Index feature for your Cursor

Focus Restore feature for your Cursor