codetraxis

A local DevTools alternative for any JavaScript project.

Tired of jumping between DevTools tabs, losing console logs, and not seeing the full network flow?

codetraxis gives you a file explorer, network inspector, and console timeline — all in one browser UI, running completely on localhost.

npx codetraxis .

Open http://localhost:3333 — that's it.

🚀 Features

• 📁 Live file tree: Browse your project in real time — respects .gitignore.
• 🧾 Code viewer: Monaco-based syntax-highlighted file viewer.
• 🌐 Network inspector: fetch / axios / XHR — method, URL, status, body, headers, duration.
• 🧠 Console timeline: log / info / warn / error — persistent, in order.
• ⚡ Real-time updates: File changes pushed via WebSocket — no refresh needed.
• 🔌 Any project: React, React Native, Next.js, Expo, Vite, CRA, plain Node.
• 🔒 100% local: Bound to 127.0.0.1 — no data ever leaves your machine.

📦 Quick start

# No install needed
npx codetraxis .

# Or globally
npm install -g codetraxis
codetraxis .

# Specific project
codetraxis ~/projects/my-app

# Custom port
PORT=4000 codetraxis .

🛠 How it works

1. Start the server: Run codetraxis in your terminal. It spins up a local UI on port 3333.
2. Install the Agent: Click Install Agent in the UI. A lightweight agent (codetraxisAgent) is safely injected into your project's entry file.
3. Debug: The agent intercepts console.*, fetch, and XMLHttpRequest and sends events via WebSocket directly to your codetraxis dashboard.

Manual axios attachment (for axios.create() instances):

import { attachAxios } from "./codetraxisAgent";

attachAxios(myAxiosInstance);

⚙️ CLI Flags

| Flag | Description | |---|---| | [path] | Target project directory (default: current dir) | | --dev | Dev mode — starts ts-node-dev + Vite dev server separately | | --help | Show usage | | PORT=XXXX | Override default port 3333 via env var |

🔒 Security

codetraxis runs fully locally.

• Server bind: 127.0.0.1 only. Not reachable from external networks.
• File access: Restricted to the target directory.
• Telemetry: Zero. No data is collected or sent anywhere.

❓ Common issues

• White screen in browser? Ensure you are running the latest version.
• Port already in use? codetraxis will automatically pick the next available port.
• Permission denied? Run chmod +x bin/cli.js.

Built because console.log debugging gets old fast.