madarX
  • Overview
  • Projects
  • Agents
  • Tasks
  • Workflows
  • Approvals
  • Marketplace
  • Settings
Loading Help…
madarX OS v1.0

Help

madarX OS v1.0 operator guide and navigation map for the local-first admin console.

Operator guideDaily command-center flow.

1. Start with agents

Create only the workers you need. The Caretaker is the safe default: daily checks, scoped tools, and owner-facing summaries.

2. Review approvals

Human-in-loop requests appear before elevated actions. Read the payload and risk level, then approve or deny from the queue.

3. Keep tools governed

The Marketplace shows enablement, availability, connector names, and approval mode. It never exposes secret values.

4. Schedule and inspect

Schedules queue heartbeat tasks; Reports gives the run/artifact trail and download links for generated report files.

ArchitectureLocal-first, auditable, approval-gated.

Main console: Next.js App Router routes for overview, admin pages, brand assets, and runtime diagnostics.

Runtime: SQLite-backed agents, schedules, runs, artifacts, approvals, and audit logs managed through lib/runtime.js and related helpers.

Workers: Heartbeat tasks are queued durably and processed one cycle at a time by the worker endpoint or daemon.

Safety model: Low-risk read tools can run automatically when enabled and permitted; writes, terminal operations, deployments, process kills, and external sends are disabled or approval-required. A fourth irreversible_external risk tier always requires human approval regardless of trust mode.

v1.0 navigation mapPrimary sidebar routes.
Overview

Main dashboard with the Main Agent composer, live runtime panels, and the artifact canvas.

Projects

Top-level project scope. Create projects, set color/status, and pick the active project for workforce work.

Agents

Manage installed workers, view tool permissions, edit skills, and inspect per-agent memory.

Tasks

Durable task queue with comments, owners, run state, and delegation timelines.

Approvals

Approve or deny pending human-in-the-loop requests with full payload and risk context.

Disk

Project-scoped file store with transcript metadata and local-only content boundaries.

Missions

Mission templates and runs that queue project-aware heartbeat work.

Audit

Search the durable audit log of actions, approvals, tool calls, and trust-mode flips.

Schedules

Upsert cron-style schedules, enable/pause them, and process heartbeat work manually.

Activity

Live activity feed across agent runs, tool calls, and sub-agent events.

Reports

Browse generated runs, artifacts, and report files with previews and download links.

Marketplace

Unified catalog of tools, skills, and bundles. Install, toggle, and inspect risk tiers.

Advanced viewsReachable by URL — not in the sidebar.
Help

This page. Operator guide and navigation map.

Settings

Global system config: trust mode, default model, tool toggles, and secrets management.

Runtime

Raw diagnostics view of the SQLite state snapshot, egress log, and heartbeat queue.

Architecture

In-app architecture explorer for the madarX OS surface and runtime layers.

Brand

Brand asset manager — logos, wordmarks, and palette tokens.

Federated AI

Cross-model comparison surface for AB-testing prompts across providers.

Onboarding

Guided first-run setup steps for the personal workforce.

Org

Org chart and reporting hierarchy for delegation across installed agents.

Tools (legacy)

Legacy alias that redirects to /marketplace?kind=tool. Update bookmarks when convenient.