DNM Agent Local

Connect your local development environment to DNM Lab. Run AI-powered development sessions directly from your machine.

Installation

npm install -g dnm-agent-local

Quick Start

# Navigate to your project directory
cd /path/to/your/project

# Start the agent
dnm-agent-local

On first run, you'll be prompted to configure your connection. You can either:

1. Paste config - Copy the connection string from DNM Lab frontend
2. Enter manually - Provide Master URL, Project ID, and Project Key
3. Interactive setup - Configure your project stack interactively

Configuration is saved to .sdd/local-signalr-config.json for future sessions.

Usage

# Start the agent (uses saved config or prompts for setup)
dnm-agent-local

# Show help
dnm-agent-local --help

# Show version
dnm-agent-local --version

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | MASTER_URL | DNM Lab backend URL | (prompted) | | PROJECT_ID | Your project ID | (prompted) | | PROJECT_KEY | Project API key (pk_proj_...) | (prompted) | | WORKSPACE_DIR | Working directory | Current directory |

How It Works

1. Connect - The agent establishes a SignalR connection to DNM Lab
2. Authenticate - Uses your project key for secure authentication
3. Work - Receives tasks from the DNM Lab frontend and executes them locally
4. Preview - Your local dev server URL is reported back for live previews

Configuration File

The agent stores configuration in .sdd/local-signalr-config.json:

{
  "masterUrl": "https://your-dnm-lab-instance.com",
  "projectId": "your-project-id",
  "projectKey": "pk_proj_...",
  "containerId": "local-your-machine-abc123",
  "enableTunnel": true,
  "tunnelPort": 5173
}

You can also embed project-specific configuration:

{
  "masterUrl": "...",
  "projectId": "...",
  "projectKey": "...",
  "containerId": "...",
  "enableTunnel": true,
  "tunnelPort": 3000,
  "version": "1.0",
  "paths": {
    "workspace": ".",
    "frontend": "./frontend",
    "backend": "./backend"
  },
  "services": {
    "frontend": {
      "port": 3000,
      "startCommand": "npm run dev",
      "extensions": [".ts", ".tsx", ".js", ".jsx"]
    },
    "backend": {
      "port": 8080,
      "startCommand": "npm start",
      "extensions": [".ts", ".js"]
    }
  }
}

Requirements

• Node.js 18+
• A DNM Lab account with a project set up
• Project API key from DNM Lab

Troubleshooting

Connection failed

• Check that your MASTER_URL is correct
• Verify your project key is valid
• Ensure you have network access to the DNM Lab server

Agent not appearing in frontend

• The agent must be running and connected
• Check the terminal for connection status
• Try restarting the agent

Preview not working

• Make sure your local dev server is running on the configured port
• Check that tunnelPort matches your dev server port

License

MIT