nyxora-agent

Configure, operate, and extend the Nyxora Agent CLI framework across platforms.

5|2|Updated May 26, 2026
One-click install
npx skills add https://github.com/perasyudha/Nyxora --skill nyxora-agent-perasyudha
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nyxora-agent
Source: https://github.com/perasyudha/Nyxora/tree/main/packages/core/playbooks/autonomous-ai-agents/nyxora-agent
Command: npx skills add https://github.com/perasyudha/Nyxora --skill nyxora-agent-perasyudha

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Working with the Nyxora Agent framework requires knowing dozens of CLI commands, configuration options, toolsets, and platform integrations. This Skill provides a complete operating guide so an AI assistant can help you install, configure, troubleshoot, and extend Nyxora without digging through source code or docs. ## Core Features & Use Cases - CLI & Configuration Reference: Covers the full command surface (chat, setup, model, tools, skills, mcp, gateway, sessions, cron, webhooks, profiles, auth) plus config.yaml sections and provider setup for 20+ LLM providers. - Multi-Agent Spawning: Documents how to launch additional Nyxora instances via one-shot commands or tmux-based interactive PTY sessions for parallel autonomous work. - MCP & Webhook Integration: Reference files explain the native MCP client (stdio/HTTP servers, tool discovery, sampling) and webhook subscriptions that trigger agent runs from GitHub, Stripe, or CI/CD events. - Use Case: You want Nyxora to react to new GitHub issues automatically. The Skill guides you through enabling the webhook platform, creating a subscription with a prompt template, and delivering the agent's triage response to Telegram. ## Quick Start Ask the assistant to help you install Nyxora, pick a model provider, and run your first chat command using the nyxora CLI.

Frequently Asked Questions about nyxora-agent

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install and set up Nyxora Agent?

Install Nyxora with the shell installer (curl -fsSL https://nyxora-agent.nousresearch.com/install.sh | bash) or via pip install nyxora-agent. Then run nyxora setup for the interactive wizard, nyxora model to pick a provider, and nyxora doctor to verify dependencies.

How do I connect MCP servers to Nyxora Agent?

Add servers under the mcp_servers key in ~/.nyxora/config.yaml using either a command (stdio) or url (HTTP) transport, then restart the agent. Nyxora discovers tools at startup and registers them with the mcp_{server}_{tool} naming prefix.

Which LLM providers does Nyxora Agent support?

Nyxora supports 20+ providers including OpenRouter, Anthropic, OpenAI, Google Gemini, DeepSeek, xAI, Mistral, Kimi, and local models. Configure them with nyxora model or nyxora setup, and manage OAuth or API-key credentials via nyxora auth.

How do I run multiple Nyxora agents in parallel?

Use one-shot mode with nyxora chat -q for background tasks, or spawn interactive instances in tmux sessions for long-running missions. The -w flag creates isolated git worktrees so parallel agents do not conflict on the same files.

Why are my Nyxora webhook subscriptions not triggering?

First confirm the webhook platform is enabled in config and the gateway is running, then check http://localhost:8644/health. Verify the HMAC secret matches your service, the --events filter matches the sent event type, and the URL is reachable from the external service.

Does Nyxora redact secrets from tool output?

Yes, secret redaction is enabled by default and scans tool output for API keys and tokens before they enter conversation context. It is controlled by security.redact_secrets in config and requires a new session to take effect after changes.