Nexus Agent Kit

Nexus Agent Kit is a plugin-first AI terminal workspace for Codex and Claude Code. It packages reusable skills, terminal commands, and MCP safety conventions so your AI sessions behave consistently across planning, CI/CD debugging, code review, TODO tracking, infrastructure design, tutorials, and tool-connected work.

Instead of re-explaining how you want the assistant to operate in every new repo or terminal, you install Nexus once and get a shared operating model for engineering work.

Connect

I regularly write about AI, DevOps, Cloud Infrastructure, and Software Engineering. Subscribe to get practical guides, deep dives, and updates.

If this project is useful and you want to support more open-source AI engineering work, you can sponsor it on GitHub.

Quick Start

Install In Codex

Install directly from this GitHub repo:

npx codex-marketplace add aayushostwal/nexus --plugin --global

Project-scoped install:

npx codex-marketplace add aayushostwal/nexus --plugin --project

This is a direct repo install. Users need the repo slug aayushostwal/nexus; pushing this repo does not by itself make the plugin searchable in a central Codex marketplace index.

After install, Nexus automatically bootstraps global instruction files on first active plugin run:

• Claude runtime: updates ~/.claude/CLAUDE.md
• Codex runtime: updates ~/.codex/AGENT.md

If these files already exist, Nexus appends/updates only its managed block and preserves your existing content.

Install In Claude Code

/plugin marketplace add aayushostwal/nexus
/plugin install nexus@nexus-marketplace
/reload-plugins

After plugin enablement, run node scripts/bootstrap-agent-docs.js once to create or refresh the managed skills-first instruction block in your runtime instruction files.

What Nexus Does In Your Terminal

• Coordinate a multi-agent implementation by identifying which tasks can run in parallel.
• Compare approaches for modifying an existing build, deployment, or architecture flow.
• Plan a production feature before implementation.
• Debug a failing CI pipeline after a dependency or config change.
• Investigate why a deploy works locally but fails in GitHub Actions.
• Review a branch for correctness and missing tests.
• Design a production AWS or GCP architecture from a codebase with a cost estimate and Mermaid HLD.
• Audit existing Terraform or Kubernetes setup for SPOFs, security gaps, and cost waste.
• Find free or self-hosted alternatives to Firebase, Heroku, Auth0, Datadog, and other paid services.
• Build a daily brief from TODOs and connected work systems.

Skills

Skills are grouped below by role so it is easier to understand what the plugin actually adds to the terminal.

Core Operations

Skill	Category	Purpose
nexus		Shared operating rules, TODO workflows, daily briefs, and MCP safety behavior.

Planning And Research

Skill	Category	Purpose
nexus-planning		Turns an intended technical change into scope, ordered steps, dependencies, risks, validation, and rollout.
nexus-exploring		Determines the right approach when the goal is clear but the design or implementation strategy is still uncertain.

Architecture And Design

Skill	Category	Purpose
nexus-architecture		Reads a codebase and produces a structured map of service boundaries, coupling points, and refactoring opportunities.
nexus-deployment-safety		Checks a proposed change against deployment history, rollback readiness, and runtime risk factors before rollout.

Code Quality

Skill	Category	Purpose
nexus-code-review		Reviews a branch for logic correctness, regression risk, test coverage gaps, and observable behavior changes.

Infrastructure Planning

Skill	Category	Purpose
nexus-infra		Entry point for all infrastructure requests — routes to design, evaluate, or free-alternatives based on what the user needs.
nexus-infra-design		Scans a codebase and produces a professional HLD with Mermaid diagram, component table, cost estimate, and trade-off matrix.
nexus-infra-evaluate		Reads existing Terraform, K8s, docker-compose, and CI/CD files to produce a full audit report with short-term and long-term improvement plans.
nexus-infra-free-alternatives		Maps every paid cloud service to free, cheap, or self-hosted alternatives grouped by tier, with migration notes per service.

Debugging

Skill	Category	Purpose
nexus-debugging		Investigates failures and regressions with root-cause analysis, narrow fixes, verification, and prevention guidance.
debugging-common		Shared debugging rules, output patterns, and checklists.
debugging-ci-cd		CI/CD-focused debugging playbook.
debugging-codebase		Application and code regression debugging playbook.
debugging-frameworks		Framework and tooling-specific debugging playbook.

Testing

Skill	Category	Purpose
nexus-testing		Identifies why tests fail intermittently and produces targeted fixes rather than retry wrappers.

Reliability And Release

Skill	Category	Purpose
nexus-reliability		Works through an active incident with structured triage, blast radius assessment, and resolution guidance.
nexus-release-readiness		Checks a release candidate against rollback readiness, monitoring coverage, and known risk factors before shipping.

Observability

Skill	Category	Purpose
nexus-observability		Correlates error spikes, latency anomalies, and log patterns across services to surface the most likely failure origin.

Performance

Skill	Category	Purpose
nexus-performance		Entry point for all performance requests — routes to memory, dependency, or profiling tracks based on the symptom.
performance-memory-leak		Instruments a running process, identifies allocation hot paths, and confirms the fix eliminated the leak.
performance-dependency-blast-radius		Maps which modules are affected by a dependency upgrade before the upgrade is applied.

Education And Documentation

Skill	Category	Purpose
nexus-tutorial		Creates executable Jupyter-style tutorials with reproducible setup.
skill-writer		Helps create or improve new SKILL.md workflows.

Content And Social

Skill	Category	Purpose
nexus-shorts		Converts ideas, notes, or technical content into YouTube Shorts scripts.

Token Efficiency

Skill	Category	Purpose
nexus-token-optimizer		Always-on token optimization rules for efficient context gathering, tool usage, and concise responses.

Commands

Command	Category	Purpose
/add-todo		Add a classified item to the Nexus TODO system.
/daily-brief		Build a daily brief from TODOs and configured tools.
/review-branch		Review current branch changes with findings first.
/stats		Show token usage and estimated cost stats for Claude and Codex sessions.

Tool Setup Guides

Nexus is designed to work well with MCP-connected tools, but it does not ship credentials or external accounts.

Tool	Guide	What it adds to Nexus
Microsoft / Outlook	Microsoft Graph setup and permission guidance.	Mail and calendar context for daily briefs and workflow assistance.
Slack	Slack MCP connection and token scope guidance.	Workspace search, channel context, thread retrieval, and approved messaging workflows.
Notion	Notion MCP and internal integration setup guidance.	Access to pages, databases, and workspace knowledge.
Jira / Atlassian	Atlassian Rovo MCP and API token setup guidance.	Issue, sprint, board, and project context for engineering workflows.
AWS	AWS profile, role, and least-privilege MCP guidance.	Cloud status, logs, metrics, and infrastructure context with approval gates for changes.

Safety defaults used by the repo:

• Read-only by default.
• Ask before sending messages, email, Jira updates, or cloud changes.
• Keep secrets out of git.
• Prefer scoped credentials, OAuth, or temporary tokens.

How To Extend Nexus

1. Pick the tool you want to connect.
2. Open the matching setup guide in docs/tools/.
3. Configure the MCP connection or provider credentials outside git.
4. Start with read-only access.
5. Only add write permissions when your workflow actually needs them.
6. Keep Nexus approval-first for any external write, send, deploy, or update action.

Usage In Real Life

Title	Labels	Screenshots
Slack TODO Aggregator
Article to Instagram Short Script Conversion

Development

Run the local checks with:

npm test

Plugin packaging lives in:

• .agents/plugins/marketplace.json
• .codex-plugin/plugin.json
• .claude-plugin/plugin.json
• .claude-plugin/marketplace.json

License

This project is licensed under the MIT License. See LICENSE for the full text.

SEO / GEO Tags

codex plugin, claude code plugin, ai terminal workflow, developer ai assistant, ci cd debugging, github actions debugging, terminal agents, mcp tools, model context protocol, ai coding workflow, engineering planning, developer productivity, prompt engineering, tool-connected ai, slack mcp, notion mcp, jira mcp, aws mcp, ai todo manager, daily brief automation, cloud infrastructure planning, aws architecture design, gcp architecture, azure architecture, infrastructure as code review, terraform audit, kubernetes review, hld generator, cloud cost estimation, free firebase alternative, free heroku alternative, supabase, render railway flyio, self-hosted cloud, infrastructure skills, devops ai assistant