hangar-ide 0.1.4

Orchestration-first IDE for spec-driven AI development

Hangar

Plan specs. Track dependencies. Run agents. Review changes. Ship.

What is Hangar?

Hangar is a visual control surface for Beads + OpenSpec workflows. Instead of managing specs and task graphs through CLI commands, you get a real-time dashboard that covers the full development lifecycle — from initial idea to shipped feature.

The interface is split into three zones:

• Left sidebar — Ready queue (unblocked tasks) and completed epics
• Main content — Switchable between Specs (browse/manage OpenSpec changes) and Tasks (dependency DAG)
• Bottom panel — Terminal, Review, Timeline, Stats

Everything updates live. When an agent closes a task in the terminal, the DAG redraws, the timeline gains an entry, and stats recalculate — no manual refresh needed.

Install

Prerequisites

Requirement	Version	Notes
Python	3.12+	Runtime
Beads	latest	Installed automatically by the agent skill on first use
OpenSpec	latest	Installed automatically by the agent skill on first use

You typically don't need to install Beads or OpenSpec yourself — the bundled agent skills guide Claude Code through installing and configuring them when you start your first workflow.

Quick Start

# Install from PyPI
pip install hangar-ide

# Or with uv
uv tool install hangar-ide

# Or with pipx
pipx install hangar-ide

Then navigate to your project and run:

cd ~/projects/my-app
hangar

Initialize a new project

Open your browser to http://localhost:8000 and use hangar's included terminal to start your agent

Try a simple prompt to get a feel

create a web based snake game. use openspec and beads.

Check out the specs as they are generated

Check out the tasks and how they depend on each other

Tech Stack

Layer	Technology
Frontend	SvelteKit (Svelte 5)
Terminal	xterm.js with fit + web-links addons
Backend	FastAPI (Python 3.12)
PTY	Python pty + asyncio for terminal sessions
File Watcher	watchfiles (Rust notify crate)
Graph Layout	ELK.js
Task Management	Beads (bd CLI)
Spec Management	OpenSpec
Package Manager	uv (Python), npm (Node)
Testing	pytest (~260 tests), vitest (57 tests), svelte-check

Known Limitations

• Single-user — Designed for single-developer use. No authentication or concurrent access handling.
• No rate limiting — For local development this is fine; for shared deployments, add a reverse proxy.

License

MIT