Skip to content

ethanplusai/codeorb

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

CodeOrb

3D interactive knowledge graph for any codebase.

Point it at any project. Watch your codebase build itself into a JARVIS-style 3D particle graph. Files are particles, imports are connections, directories are clusters. Explore visually.

Install

npm install -g codeorb
codeorb ~/your-project

Browser opens. Your codebase assembles on screen as a 3D knowledge graph.

What you'll see

  • Build animation — watch particles spawn and connections form as your code is scanned
  • 3D knowledge graph — files are particles, imports are connections, directories are clusters
  • Click to explore — click any file node to see details, dependencies, and code preview
  • Guided tour — auto-fly through your codebase clusters
  • View modes — switch between folder view, file type view, and dependency-only view
  • Search — Cmd+K to find any file instantly
  • Screenshot — one-click capture for sharing

Options

codeorb ~/project               # Scan and open
codeorb ~/project --no-open     # Don't auto-open browser
codeorb ~/project --no-summarize # Skip AI summaries
codeorb ~/project --port 4000   # Custom port
codeorb ~/project --rescan      # Clear cache and re-scan

Keyboard shortcuts

Key Action
Cmd+K Search files
Escape Close sidebar / zoom out

Supported languages

Import/dependency parsing for: JavaScript, TypeScript, Python, Go, Rust. More coming.

The visual graph works for ANY language — it just won't show dependency connections for unsupported ones.

How it works

  1. Scans your codebase (respects .gitignore)
  2. Parses imports to build a dependency graph
  3. Computes hierarchical 3D layout reflecting actual project structure
  4. Streams scan events to browser via WebSocket
  5. Three.js renders the particle graph with JARVIS-style visuals

Requirements

  • Node.js 18+
  • Modern browser with WebGL

License

MIT

About

3D interactive knowledge graph for any codebase. JARVIS-style particle visualization.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors