honcho-ui

A self-hosted dashboard for visualizing your Honcho memory server — workspaces, peers, sessions, and conclusions.

Built with Next.js 15 (App Router), React 19, TypeScript, Tailwind CSS v4, shadcn/ui, SWR, and Recharts.

Features

• Overview — KPIs and activity charts for your Honcho instance
• Workspaces — browse all workspaces
• Peers — peer representations and cards
• Sessions — expandable threads with summaries
• Conclusions — filterable list with semantic search
• Global search — search across all Honcho data

Requirements

• A running Honcho API server (default: http://localhost:8001)
• Node.js 18+ / npm

Getting Started

npm install
npm run dev

The app runs under the /honcho/ base path. Create a .env.local with:

HONCHO_API_URL=http://localhost:8001

All Honcho data flows through the Next.js API proxy (app/api/honcho/...) server-side — the browser never talks to the Honcho API directly.

Production

npm run build
npm start   # serves on port 3456 by default (behind an nginx /honcho/ proxy)

Stack

• Next.js 15 (App Router, src/ dir)
• React 19 + TypeScript
• Tailwind CSS v4 + shadcn/ui
• SWR (data fetching) + Recharts (charts) + lucide-react (icons)