convez.ai
MCP ServerDevOps & InfraestruturaAvançado
aayushostwal

Nexus Agent Kit

aayushostwal/nexus

Terminal inteligente com skills reutilizáveis para IA em múltiplos contextos de engenharia

Ver no GitHub
BomPluginScore · de 0 a 100

MCP server que funciona como terminal AI plugin-first para Claude Code e Codex. Fornece skills reutilizáveis, comandos de terminal, e convenções de segurança MCP para manter consistência em planejamento, debug de CI/CD, revisão de código, rastreamento de TODOs e integração com ferramentas.

Instalação

$npx convez-ai aayushostwal/nexus

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
19
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 1 mês
Versão
v1.35.0
Issues abertas
2
Contribuidores
3

Casos de uso

  • Debug de pipelines CI/CD com assistência de IA
  • Planejamento e organização de projetos com rastreamento de TODOs
  • Revisão de código e design de infraestrutura assistidos por IA

Veredito

MCP server robusto voltado para engenheiros que trabalham com múltiplos fluxos (CI/CD, infraestrutura, code review). A abordagem plugin-first com bootstrapping automático de instruções reduz configuração manual, mas exige familiaridade com Codex/Claude Code e ter de reusar em vários contextos para justificar a complexidade inicial.

README

A tradução para o português deste README ainda está na fila.

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

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

SkillCategoryPurpose
nexusOperationsShared operating rules, TODO workflows, daily briefs, and MCP safety behavior.

Planning And Research

SkillCategoryPurpose
nexus-planningCoding PlanningTurns an intended technical change into scope, ordered steps, dependencies, risks, validation, and rollout.
nexus-exploringExploration ResearchDetermines the right approach when the goal is clear but the design or implementation strategy is still uncertain.

Architecture And Design

SkillCategoryPurpose
nexus-architectureArchitecture DesignReads a codebase and produces a structured map of service boundaries, coupling points, and refactoring opportunities.
nexus-deployment-safetyArchitecture ReliabilityChecks a proposed change against deployment history, rollback readiness, and runtime risk factors before rollout.

Code Quality

SkillCategoryPurpose
nexus-code-reviewReview CodingReviews a branch for logic correctness, regression risk, test coverage gaps, and observable behavior changes.

Infrastructure Planning

SkillCategoryPurpose
nexus-infraInfrastructure CloudEntry point for all infrastructure requests — routes to design, evaluate, or free-alternatives based on what the user needs.
nexus-infra-designInfrastructure PlanningScans a codebase and produces a professional HLD with Mermaid diagram, component table, cost estimate, and trade-off matrix.
nexus-infra-evaluateInfrastructure ReviewReads 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-alternativesInfrastructure CostMaps every paid cloud service to free, cheap, or self-hosted alternatives grouped by tier, with migration notes per service.

Debugging

SkillCategoryPurpose
nexus-debuggingDebuggingInvestigates failures and regressions with root-cause analysis, narrow fixes, verification, and prevention guidance.
debugging-commonDebuggingShared debugging rules, output patterns, and checklists.
debugging-ci-cdDebugging CI/CDCI/CD-focused debugging playbook.
debugging-codebaseCoding DebuggingApplication and code regression debugging playbook.
debugging-frameworksDebugging ToolingFramework and tooling-specific debugging playbook.

Testing

SkillCategoryPurpose
nexus-testingTesting DebuggingIdentifies why tests fail intermittently and produces targeted fixes rather than retry wrappers.

Reliability And Release

SkillCategoryPurpose
nexus-reliabilityReliability OperationsWorks through an active incident with structured triage, blast radius assessment, and resolution guidance.
nexus-release-readinessReliability PlanningChecks a release candidate against rollback readiness, monitoring coverage, and known risk factors before shipping.

Observability

SkillCategoryPurpose
nexus-observabilityObservability DebuggingCorrelates error spikes, latency anomalies, and log patterns across services to surface the most likely failure origin.

Performance

SkillCategoryPurpose
nexus-performancePerformanceEntry point for all performance requests — routes to memory, dependency, or profiling tracks based on the symptom.
performance-memory-leakPerformance DebuggingInstruments a running process, identifies allocation hot paths, and confirms the fix eliminated the leak.
performance-dependency-blast-radiusPerformance PlanningMaps which modules are affected by a dependency upgrade before the upgrade is applied.

Education And Documentation

SkillCategoryPurpose
nexus-tutorialTeaching DocumentationCreates executable Jupyter-style tutorials with reproducible setup.
skill-writerDocumentation CodingHelps create or improve new SKILL.md workflows.

Content And Social

SkillCategoryPurpose
nexus-shortsSocials ContentConverts ideas, notes, or technical content into YouTube Shorts scripts.

Token Efficiency

SkillCategoryPurpose
nexus-token-optimizerOperationsAlways-on token optimization rules for efficient context gathering, tool usage, and concise responses.

Commands

CommandCategoryPurpose
/add-todoOperations TODOsAdd a classified item to the Nexus TODO system.
/daily-briefComms BriefingBuild a daily brief from TODOs and configured tools.
/review-branchReview CodingReview current branch changes with findings first.
/statsOperationsShow 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.

ToolGuideWhat it adds to Nexus
Microsoft / OutlookMicrosoft Graph setup and permission guidance.Mail and calendar context for daily briefs and workflow assistance.
SlackSlack MCP connection and token scope guidance.Workspace search, channel context, thread retrieval, and approved messaging workflows.
NotionNotion MCP and internal integration setup guidance.Access to pages, databases, and workspace knowledge.
Jira / AtlassianAtlassian Rovo MCP and API token setup guidance.Issue, sprint, board, and project context for engineering workflows.
AWSAWS 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

TitleLabelsScreenshots
Slack TODO AggregatorSlack TODOs ProductivitySlack TODO Aggregator
Article to Instagram Short Script ConversionContent Instagram ShortsArticle 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

Ver o original no GitHub

Bom para

Relacionados