STATUS / PUBLICSOURCE / PYTHONSYSTEM / CODE EXPLORER

PROJECT

VisiCLI

Gesture-Controlled Python Code Explorer

A terminal-based code explorer that maps Python packages, files, classes, functions, and selected relationships into a navigable hierarchy controlled by hand gestures or keyboard input.

  • Python
  • AST
  • OpenCV
  • MediaPipe
  • CLI

INTERFACE

VisiCLI's project map, terminal navigation, and visual interface for exploring Python code structure.

VisiCLI project explorer showing a navigable map of Python code structure
VisiCLI terminal interface with project hierarchy and gesture input
VisiCLI project visualization showing code elements as terminal cards

PROBLEM

Understanding the structure of a Python codebase from a terminal can require jumping between files and tools, while importing a project just to inspect it can execute code with unintended side effects.

APPROACH

Parse Python source with a bounded, deterministic AST scan and present the resulting structure as terminal cards with hierarchical navigation, keyboard controls, and optional webcam-driven gestures.

ARCHITECTURE

PYTHON SOURCE
BOUNDED AST SCAN
PROJECT GRAPH
EXPLORER CONTROLLER
TERMINAL VIEW
GESTURE / KEYBOARD INPUT

ENGINEERING DECISIONS

  • Analyze source without importing or executing the inspected project
  • Bound scans with directory exclusions and file, byte, and definition limits
  • Separate project analysis, graph modeling, navigation, and terminal rendering
  • Keep keyboard demo and camera-driven gesture input as distinct modes

EVIDENCE

  • Repository available
  • Linux user-level installer
  • Automated tests for analysis, navigation, and gesture handling
  • 3 interface screenshots

REPOSITORY

https://github.com/AdolfMacro/VisiCLI

NEXT

All work