Metadata-Version: 2.4
Name: claude-ns-hub
Version: 0.2.0
Summary: Claude-native AI project hub — North Star milestone tracking, live exec sessions, entity-corpus, CTX alignment.
License: MIT
Project-URL: Homepage, https://github.com/jaytoone/claude-client-bootstrap
Project-URL: Issues, https://github.com/jaytoone/claude-client-bootstrap/issues
Keywords: ai,project-management,claude,northstar,milestones,productivity
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: Topic :: Office/Business :: Scheduling
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: fastapi>=0.110
Requires-Dist: uvicorn[standard]>=0.29
Requires-Dist: httpx>=0.27
Requires-Dist: pyyaml>=6.0
Requires-Dist: ptyprocess>=0.7
Requires-Dist: anthropic>=0.28
Provides-Extra: ctx
Requires-Dist: ctx-server>=0.1; extra == "ctx"

# northstar-hub

**Personal AI project management hub** — North Star milestone tracking, live Claude sessions, CTX context alignment, and team productivity.

## Install

```bash
pip install northstar-hub
```

## Quick start

```bash
# Start the hub (binds to Tailscale IP or localhost)
northstar-hub

# Or start with CTX integration (auto-discovers CTX at :8787)
northstar-hub --with-ctx
```

Open `http://localhost:9000` in your browser.

## Features

- **North Star** — milestone pipeline management with AI execution loop
- **CTX** — real-time context alignment showing what Claude is working on
- **Corpus** — skill/agent list with live entity-corpus dashboard
- **PTY terminal** — interactive Claude session directly in the detail card
- **Exec sessions** — autonomous Claude loops dispatched per project

## CTX integration

If you already run CTX (`ctx-server` on port 8787), northstar-hub auto-discovers it at startup and shows it in the **CTX** tab. No configuration needed.

CTX users: install northstar-hub to get project milestone management alongside your context tracking.

```bash
pip install northstar-hub ctx-server  # install both
northstar-hub --with-ctx              # starts both services
```

## Configuration

Hub data lives in `~/.claude/hub/projects/` — one YAML file per project.
