@moxxy/cli

User-facing CLI for Moxxy agent orchestration.

Installation

npm install -g @moxxy/cli

Quick Start

# Interactive setup — walks you through each config step
moxxy config init

# Or pass flags directly
moxxy config init --sdk claude --github-token ghp_xxx

# Add a repository to watch
moxxy repo add owner/repo --events issues.opened,issues.labeled

# Start orchestration
moxxy start

Commands

moxxy config init

Initialize configuration. Launches an interactive wizard when called without flags.

| Flag | Description | Default | |------|-------------|---------| | --sdk <provider> | molt or claude | (interactive) | | --github-token <token> | GitHub personal access token | (interactive) | | --gateway-url <url> | Molt Gateway URL (molt only) | | | --auth-token <token> | Molt Gateway auth token | | | --claude-api-key <key> | Anthropic API key (claude only) | | | --claude-model <model> | Claude model | claude-sonnet-4-5 | | --claude-cli-path <path> | Path to Claude CLI binary | claude | | --webhook-secret <secret> | GitHub webhook secret | | | --webhook-port <port> | Webhook server port | 3456 | | --agent-id <id> | Agent ID | |

moxxy config set <key> <value>

Set a config value using dot notation (e.g. moxxy config set webhook.port 8080).

moxxy config get <key>

Read a config value using dot notation.

moxxy repo add <owner/repo>

Add a repository to watch.

| Flag | Description | Default | |------|-------------|---------| | --branch <branch> | Default branch | main | | --events <events> | Comma-separated events | issues.opened,issues.labeled |

moxxy repo list

List all configured repositories.

moxxy repo remove <owner/repo>

Remove a repository from the watch list.

moxxy start

Start the orchestration server. Connects to the configured SDK, initializes the agent supervisor, and starts the webhook server to listen for GitHub events on watched repositories.

moxxy status

Display current configuration: SDK provider, GitHub token status, webhook settings, watched repositories, and agent configuration.

Connecting to GitHub

Moxxy uses standard GitHub repository webhooks (no GitHub App required). You need a GitHub Personal Access Token and a publicly reachable URL for your webhook server.

1. Generate a webhook secret

openssl rand -hex 32

Save this value — you'll use it in both Moxxy config and GitHub.

2. Initialize Moxxy

moxxy config init

The interactive wizard will ask for your SDK provider, GitHub PAT, webhook secret, and port. Or pass flags directly:

moxxy config init \
  --sdk claude \
  --github-token ghp_xxx \
  --webhook-secret your-secret \
  --webhook-port 3456

3. Expose the webhook server

Moxxy listens on localhost:3456 by default. For GitHub to reach it, expose it with a tunnel:

ngrok http 3456

This gives you a public URL like https://abc123.ngrok-free.app.

4. Add a webhook on GitHub

Go to your repository Settings > Webhooks > Add webhook:

| Field | Value | |-------|-------| | Payload URL | https://<your-ngrok-url>/webhook/github | | Content type | application/json | | Secret | the same secret from step 1 | | Events | select "Let me select individual events" > check Issues |

5. Add the repo and start

moxxy repo add owner/repo
moxxy start

Open an issue on the repo to verify Moxxy picks it up.

Webhook details

• Path: /webhook/github (fixed)
• Signature verification: HMAC-SHA256 via X-Hub-Signature-256 header. Optional but recommended — if no secret is configured, all requests are accepted.
• Supported events: issues (actions: opened, labeled)

Programmatic Usage

import { createProgram, ConfigManager } from '@moxxy/cli';

const manager = new ConfigManager();
await manager.load();
console.log(manager.get('sdk'));

License

MIT