# Harness Nexus wiki

**Harness Nexus** is a unified management platform for Agent-tool assets
(Claude Code, Codex, DeepSeek, OpenCode, pi, Hermes …) across machines: consume
upstream MCP servers once and re-expose one aggregated server to every tool,
version skills/hooks/sub-agents/rules/MCP definitions into installable
profiles, manage remote machines through a daemon, and chat with every agent
from one portal.

This wiki holds the **feature guides** (what the product does — user-facing)
and the **development process docs** (PRDs, technical designs, research notes,
the historical roadmap).

- Source & README: [sinrimin/harness-nexus](https://github.com/sinrimin/harness-nexus)
- How to contribute: [CONTRIBUTING.md](https://github.com/sinrimin/harness-nexus/blob/main/CONTRIBUTING.md)
- Code-coupled contract docs stay in the repo:
  [docs/architecture.md](https://github.com/sinrimin/harness-nexus/blob/main/docs/architecture.md)
  and [docs/adr/](https://github.com/sinrimin/harness-nexus/tree/main/docs/adr)

## Feature guides

| Guide | Covers |
| ----- | ----- |
| [Authentication](authentication.md) | users, roles, JWT sessions, personal access tokens |
| [Credentials](credentials.md) | named secrets, `${cred:…}` injection, encryption at rest |
| [MCP management](mcp-management.md) | upstream servers, aggregated `/mcp` outlet, tool inspection |
| [Profiles & installation](profiles-and-installation.md) | profile bundles, `hnx install`, the Claude Code marketplace emitter |
| [Resources](resources.md) | skills, hooks, sub-agents, rules, commands |
| [Skill hub](skill-hub.md) | marketplace browse + multi-source skill search |
| [LLM providers](llm-providers.md) | provider routes, model discovery, multi-model |
| [Machines & daemon](machines-and-daemon.md) | enrollment, the `hnx` daemon, inventory reports |
| [Remote deploy & import](remote-deploy.md) | deploy jobs, inventory scan/diff/import |
| [Portal chat](chat.md) | chatting with agents, sessions, the composer, permissions |
| [Harness runtime management](harness-runtime-management.md) | installing/upgrading the agent CLIs, provider config push |
| [Supported agents](supported-agents.md) | the per-agent capability matrix |

## For developers

- [Documentation map](doc-map.md) — what PRD / design / research docs are, indexed by phase
- [Web console design system](design-ui-system.md) — skeleton, content language and interaction rules of the console (issue #23)
- [Skin system](design-skin-system.md) — the skin axis: tokens, hooks, the status device, the snapshot rig (issue #23)
- [Historical roadmap](roadmap.md) — phase status through Phase 9 W16 (2026-09); forward planning now lives in [issues + milestones](https://github.com/sinrimin/harness-nexus/milestones)
- Development workflow (issues, branches, verification, releases): [CONTRIBUTING.md](https://github.com/sinrimin/harness-nexus/blob/main/CONTRIBUTING.md)

> The maintainer's local verification-rig notes (`test-rig.md`) are
> machine-specific and deliberately unpublished.