nexus
Nexus conversational PI agent architecture, development, and deployment. Use when working on the Nexus orchestrator, gateway, or tools.
npx skills add majiayu000/claude-skill-registry --skill nexus --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Nexus Agent Nexus is the conversational personal intelligence (PI) agent — a single agentic loop using the Strands Agent SDK, orchestrated by Temporal. ## Architecture ``` UI (WebSocket) → Nexus Gateway (FastAPI) → Temporal Signal → Orchestrator Workflow → run_agent_turn Activity → Strands Agent (think → act → observe loop) → Core Tools (read/write/edit/bash) → MCP Tools (memory, skills, fetch) → Custom Tools (web_search) → Response via Redis PubSub → Gateway → UI ``` ### Key Differences from Syndicates | Aspect | Syndicates | Nexus | |--------|-----------|-------| | Pattern | Multi-agent orchestration | Single agentic loop | | SDK | Custom framework agents | Strands Agent SDK | | Config | `kubani.framework.config` (YAML) | Environment variables | | Workflow | Multiple specialized workflows | Entity workflow pattern | | Interaction | Event-driven, autonomous | Conversational, user-initiated | ## Components | Component | Location | Purpose | |-----------|----------|---------| | Orchestrator | `kubani/nexus/orchestrator/` | Temporal worker, activities, workflow | | Gateway | `kubani/nexus/gateway/` | FastAPI, WebSocket, Discord bridge | | Tools | `kubani/nexus/orchestrator/tools/`
- Architecture
- Key Differences from Syndicates
- Components
- Entity Workflow Pattern
- Key Files
- Local Development
- Configuration
- Building & Deploying
- Testing Changes
Setup cd kubani/nexus/orchestrator cp ../../nexus/.env.example .env # Edit with credentials Run worker locally source .env && python -m kubani.nexus.orchestrator.worker Run gateway (separate terminal) cd kubani/nexus/gateway source .env && python -m kubani.nexus.gateway.main Build container earthly +nexus-orchestrator
What does the nexus skill do?
Nexus conversational PI agent architecture, development, and deployment. Use when working on the Nexus orchestrator, gateway, or tools.
How do I install it?
Run `npx skills add majiayu000/claude-skill-registry --skill nexus --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From majiayu000/claude-skill-registry, a repository with 534 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.
