Skip to content

oscarqht/den

Repository files navigation

Den

Den is a local control center for AI coding work. It gives every task its own isolated workspace, so agents can work in parallel, stay organized, and make changes you can review with confidence.

Not just one chat box. More like a workspace where you can hand off real work, keep it reviewable, and move from idea to shipped changes without playing copy-paste ping-pong all day.

Our Philosophy

Den helps turn ideas into code, documents, designs, and reviewed outcomes.

It should feel less like “asking an assistant a question” and more like “assigning work to a capable team” that can:

  • understand the problem
  • organize the right effort
  • execute the work
  • review the result
  • keep the project moving

What Den Does Today

  • Spins up isolated work sessions for tasks, so experiments do not spill all over your main branch.
  • Lets you work with Codex, Gemini, and Cursor from one place.
  • Supports fast retries with saved drafts and new-attempt flows.
  • Handles local repos, cloned repos, and multi-repo project setups.
  • Gives each session a proper workspace with agent and dev terminals side by side.
  • Shows Git status, diffs, history, branches, stashes, and merge/rebase actions in the app.
  • Remembers project settings, credentials, and session state so you can stop and resume without ceremony.
  • Keeps session state in sync while agents run so the current session view stays up to date.

Where It’s Going

The long-term goal is bigger than “run an agent in a repo.”

Den is meant to become an AI engineering organization inside your workspace: adaptive, proactive, reviewable, and trustworthy. Sometimes that means a simple implementation task. Sometimes it means planning, coding, design exploration, documentation, and review happening together in isolated sessions.

Over time, Den should help with not only assigned work, but also the next useful work: triaging issues, finding bugs, fixing worthwhile problems, spotting technical debt, proposing improvements, and helping humans stay in control of the whole system.

Getting Started

Run locally

npm install
npm run dev

Then open the local URL printed in the terminal, pick a project, choose an agent, and start a session.

Expose Den on your tailnet with Tailscale

Prerequisites:

  • tailscale installed and already connected to your tailnet, or ready to complete tailscale up
  • Den listening on 127.0.0.1:3200
npm run dev -- --port 3200
npm run tailscale

If the machine is not logged into Tailscale yet, the script runs tailscale up and lets Tailscale print the login flow in your terminal. Once connected, it exposes 127.0.0.1:3200 to other devices on the same tailnet with Tailscale Serve and prints the reachable tailnet URLs.

To remove the Tailscale Serve mapping:

npm run tailscale:stop

If npm run tailscale had to bring the machine onto the tailnet itself, npm run tailscale:stop also runs tailscale down. If the machine was already connected, it only removes the Den exposure.

Run with npx

npx den-ai

Den starts on an available local port, usually 3200.

What You’ll Need

  • Node.js and npm
  • At least one supported agent CLI installed, such as codex, gemini, or Cursor Agent CLI
  • tmux and ttyd for the full terminal experience

Remote Access

Den no longer includes a built-in login gate. If you expose it on a non-local network or tunnel it to the internet, access control has to come from your network or reverse proxy layer.

Channels

npm run channel:nport
npm run channel:ngrok

Use these only when you understand the security implications of exposing a local control surface remotely.

npm run channel remains an alias for npm run channel:nport.

Guiding Principle

Den should be:

  • proactive
  • capable
  • adaptive
  • reviewable
  • trustworthy

Human-controlled, with a lot less babysitting.

About

Den is a local session manager for AI coding agents. It lets you pick a Git repository, start an isolated worktree session, launch an agent CLI in a browser terminal, and manage the session lifecycle from one UI.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors