Thenos Code

Compiler-grade engineering intelligence for production applications.

Thenos Code is a local-first VS Code extension for deterministic project analysis, architecture intelligence, performance review, bundle optimization, DSA complexity detection, Lighthouse-oriented heuristics, and safe AST-based refactoring.

It is not an AI autocomplete tool, chatbot, or Copilot clone. It is an engineering optimization and architecture intelligence platform that runs on your machine.

Privacy

Your code stays on your machine.

Thenos Code does not upload source code by default. The MVP is offline-first and local-first.

Capabilities

• Project scanner for routes, imports, components, dependencies, and architecture boundaries
• TypeScript AST intelligence for functions, loops, React components, hooks, JSX, and complexity risks
• Bundle intelligence for heavy imports, tree-shaking risks, duplicate dependency families, and dynamic import opportunities
• DSA analysis for nested loops, repeated traversals, recursion risks, memory-heavy patterns, and complexity improvements
• React performance analysis for unstable render props, state explosion, hydration-heavy components, and expensive render paths
• Lighthouse and SEO heuristics for image optimization, metadata, heading structure, accessibility, CLS, and hydration cost
• Architecture intelligence for circular dependencies, oversized modules, over-coupling, Next.js route safety, and scalable folder boundaries
• Safe refactor previews using AST-structured transformations with before/after diff review
• Real-time open-file intelligence with diagnostics, gutter markers, inline decorations, hovers, code lenses, and file health scores
• Contextual quick fixes for deterministic optimizations such as import cleanup and accessibility-safe image fixes
• Deterministic TAB completions for optimization comments such as expensive filters, render reduction, hook extraction, and dynamic imports
• Smart file priority ranking for top engineering risks, bundle pressure, memory pressure, render pressure, and architecture risk
• Autonomous scan mode with prioritized optimization queue and execution order
• Input-driven deterministic refactors with diff preview
• Engineering Restore Points and rollback for applied optimizations
• Optimization modes: Safe, Engineering, Aggressive, and Compiler
• Comment-driven directives such as // thenos-optimize, // thenos-reduce-bundle, // thenos-improve-complexity, and // thenos-fix-rerenders
• Local engineering timeline that tracks score, bundle, complexity, rerender, and finding deltas across scans
• Premium dark engineering dashboard inside the VS Code activity bar

Commands

• Thenos: Scan Project
• Thenos: Autonomous Scan
• Thenos: Optimize File
• Thenos: Reduce Bundle Size
• Thenos: Analyze Architecture
• Thenos: Generate Engineering Report
• Thenos: Detect Complexity Issues
• Thenos: Optimize Rendering
• Thenos: Safe Refactor Component
• Thenos: Fix with Thenos
• Thenos: Apply Input Refactor
• Thenos: Set Optimization Mode
• Thenos: Rollback Last Optimization
• Thenos: Show Line Suggestion
• Thenos: Open File Intelligence

Shortcut

• Ctrl+Alt+T / Cmd+Alt+T: apply a deterministic Thenos fix on the active line when a safe code update is available.
• Ctrl+Alt+I / Cmd+Alt+I: open input-driven deterministic refactor.
• Alternate shortcuts are available when Ctrl+Alt is intercepted: Ctrl+Shift+Alt+T and Ctrl+Shift+Alt+I.

Reports

Thenos: Generate Engineering Report creates one complete project report with scores, before/after potential, engine metrics, top risky files, prioritized optimization queue, and all findings.

Development

npm install
npm run compile

Press F5 in VS Code to launch the extension host.

MVP Scope

Thenos Code currently focuses on instant local value:

• No login
• No cloud dependency
• No source upload
• Deterministic scanning
• TypeScript Compiler API based analysis
• Safe preview-before-apply refactors
• No external AI API dependency for core intelligence

Future architecture can support optional cloud sync, team dashboards, CI/CD integration, optimization history, GitHub login, organization reporting, and enterprise analytics without changing the local-first core.