Setting Up Aidis

Aidis is a desktop application for managing your AI agents. It provides a visual interface for everything you'd normally do through the CLI.

Note: Aidis currently depends on the zeroclaw CLI for agent operations. The zeroclaw binary must be installed and available on your system PATH.

Prerequisites

1. Install zeroclaw CLI — Follow the official zeroclaw installation guide to install the agent runtime. The zeroclaw binary must be available on your system PATH.

2. Node.js >= 18 and npm >= 9

Install & Run

# Clone the repository
git clone https://github.com/nicholasbester/aidis.git
cd zeroclaw-ui

# Install dependencies
npm install

# Build and run the app
npm run build && npm run preview

Development Mode

If you want to run with hot-reload for development:

npm run dev

First Launch

When you start Aidis for the first time, the Onboarding Wizard will walk you through:

1. Detect Installation — Confirms the zeroclaw CLI is installed and shows the binary path
2. Provider Setup — Select your LLM provider (OpenRouter, OpenAI, Anthropic, etc.) and enter your API key
3. Channel Setup — Configure your primary communication channels (Telegram, Discord, Slack, etc.)
4. Test Connection — Send a test message to verify your agent is responding

What You Can Do

Dashboard

Monitor your agent daemon in real-time. Start, stop, and restart the daemon. View streaming logs with search and filtering. Run diagnostics with the built-in doctor and channel health checks.

Agent Workspace

Shape your agent's personality and behavior through visual markdown editors:

• Identity — Name, creature type, vibe, and emoji
• Soul — Personality traits, values, and communication style
• Agent — Workflows, tools, and safety rules
• User — Your context and preferences
• Memory — Long-term curated memory
• Heartbeat — Recurring maintenance tasks with interval scheduling
• Tools — Tool usage guidelines and environment notes

All workspace editors include AI-assisted content generation.

Skills

Browse and install skills from the community marketplace. Manage installed skills and install custom skills from any URL.

Chat

Test your agent with a built-in chat interface featuring real-time message streaming.

Settings

Edit all 29 sections of the agent configuration:

• General — Provider, model, temperature
• Channels — 15+ integrations (Telegram, Discord, Slack, WhatsApp, Matrix, Signal, Email, IRC, and more)
• Model Routes — Route hints for model and embedding selection
• Scheduler — Cron job management with interval, time-based, and one-shot scheduling
• Autonomy — Access levels, blocked commands, allowed domains
• Runtime — Reasoning, streaming, token limits, timeouts
• Cost — Budget enforcement with daily and monthly limits
• Observability — Log levels, tracing, OpenTelemetry export
• Gateway, Memory, Browser, Web Search, Storage, Secrets — and more

zeroclaw CLI Documentation

For documentation on the zeroclaw CLI (the agent runtime), see the official zeroclaw website.