whatisgithub

What is huginn?

tohuw/huginn — explained in plain English

Analysis updated 2026-05-18

2PythonAudience · developerComplexity · 3/5Setup · easy

In one sentence

A local dashboard that tracks multiple AI coding agent sessions like Claude Code and Codex, showing which ones need attention and letting you ask questions about them.

Mindmap

mindmap
  root((repo))
    What it does
      Tracks agent sessions
      Flags sessions needing attention
      Ask panel for status questions
    Tech stack
      Python
      uv
      Electron apps
    Use cases
      Monitor multiple coding agents
      Jump to a specific terminal tab
      Steer a session with confirmation
    Audience
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Monitor multiple Claude Code or Codex terminal sessions from one dashboard.

USE CASE 2

Get notified when a session is waiting on a permission prompt or has errored.

USE CASE 3

Ask a chat panel questions about what a running agent session is doing.

USE CASE 4

Jump directly to the terminal tab of a specific agent session.

What is it built with?

Pythonuv.NET

How does it compare?

tohuw/huginn0-bingwu-0/live-interpreter010zx00x1/faresnipe
Stars222
LanguagePythonPythonPython
Setup difficultyeasymoderateeasy
Complexity3/52/52/5
Audiencedevelopergeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Windows support is covered by automated tests but has not been verified on a real Windows machine.

No license information is provided in the README.

So what is it?

Huginn is a local activity dashboard for people who run several AI coding agents at once, like Claude Code or Codex, often across different terminal windows or project folders. Instead of tabbing between many terminals to check on each agent, Huginn watches all of them from one console and shows which ones need attention, which are still working, and which have finished or hit an error. It also shows lighter, app-level activity for desktop apps like Claude Desktop and ChatGPT Desktop, though it cannot see the actual conversation content for those, since that lives in the cloud. Everything runs locally on the user's own machine. The only outside communication happens when the tool itself calls Claude or Codex on the user's behalf, using the same authentication the user already has. A command starts a background service and opens a web dashboard, and other commands can reopen that dashboard, run a self-contained fictional demo for safely taking screenshots, show a one-time status table in the terminal, or install hooks so state changes are detected almost instantly. There is also a native menu bar app for macOS and a tray app for Windows that manage the background service and show an attention count. Each tracked terminal session is watched only, not controlled, by default. Sending an actual command or interrupting a session requires explicitly switching that session into a separate steering mode first, and even then, every command must be confirmed by typing yes before it is sent, with confirmations that expire quickly and cannot be reused. The dashboard sorts sessions so the ones needing a person's attention appear first, and clicking a session can jump to its exact terminal tab, show a short transcript preview, or open a chat panel where a person can ask questions about what an agent is currently doing. Huginn is installed and run using the uv Python tool, and its own skill file can be linked into other agent setups so agents can query it directly using a small set of commands like checking the roster or inspecting a specific session.

Copy-paste prompts

Prompt 1
Help me install and run tohuw/huginn to monitor my Claude Code sessions.
Prompt 2
Explain the difference between observe mode and steer mode for a session.
Prompt 3
Walk me through building the macOS menu-bar app for Huginn.
Prompt 4
Explain what each session state like working, waiting_permission, and done means.

Frequently asked questions

What is huginn?

A local dashboard that tracks multiple AI coding agent sessions like Claude Code and Codex, showing which ones need attention and letting you ask questions about them.

What language is huginn written in?

Mainly Python. The stack also includes Python, uv, .NET.

What license does huginn use?

No license information is provided in the README.

How hard is huginn to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is huginn for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.