🔍 CursorFocus: Real-time Project Structure Analyzer

:mag: CursorFocus: Real-time Project Structure Analyzer

What is CursorFocus?

CursorFocus is a lightweight Python tool that provides a live, auto-updating view of your project’s structure, functions, and environment. Think of it as a “living documentation” that keeps you and your team informed about your project’s organization in real-time.

Key Features

  • :arrows_counterclockwise: Real-time Updates: Automatically refreshes every 60 seconds

  • :memo: Smart Project Detection: Automatically recognizes project types (Chrome Extensions, Node.js, Python)

  • :deciduous_tree: Function Analysis: Extracts and documents functions from your code

  • :dart: Project Overview: Maintains an up-to-date summary of your project structure

  • :gear: Environment Tracking: Monitors environment variables (excluding sensitive data)

  • :hammer_and_wrench: Easy Configuration: Simple setup with customizable options

Why I Built This

As a developer, I often found myself needing a quick way to understand project structures, especially when working with multiple projects or returning to a project after some time. CursorFocus solves this by maintaining an always-current view of your project’s organization.

How It Works

  1. Install CursorFocus in your project

  2. Run the setup script

  3. Get an auto-updating Focus file with your project’s structure

  4. Stay informed about your project’s organization without manual documentation

Perfect For

  • Teams onboarding new developers

  • Managing multiple projects

  • Understanding complex codebases

  • Maintaining up-to-date project documentation

  • Quick project structure overview

Installation


git clone https://github.com/Dror-Bengal/CursorFocus.git CursorFocus

cd CursorFocus

pip install -r requirements.txt

python3 setup.py --project /path/to/your/project

python3 focus.py

Try It Out!

The project is open-source and available on GitHub: CursorFocus Repository

Feel free to try it out, contribute, or suggest improvements! :rocket:

#ProjectManagement #Documentation #DeveloperTools #Python #Productivity

10 Likes

It would be great if this was a vscode plugin. A plugin that we can run whenever we want and stop whenever we want

3 Likes

If possible, I could make it an extension, but I’m not sure if it will work.

2 Likes

LOVE IT!! Nice work.

1 Like

The creator seems to be very busy right now, I tagged him on discord but got no reply. If possible, I will continue to develop this project.