### Setup Development Environment

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/development/contributing.md

Install dependencies, build Rust components, and start the development server.

```bash
nvm use
pnpm install
pnpm --filter @dotagents/desktop build-rs
pnpm dev
```

--------------------------------

### Quick Start: Clone and Install

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/development/setup.md

Clones the repository, navigates into the directory, sets the Node.js version, installs dependencies, builds the Rust binary, and starts the development server.

```bash
git clone https://github.com/aj47/dotagents-mono.git
cd dotagents-mono
nvm use
pnpm install
pnpm --filter @dotagents/desktop build-rs    # Build Rust native binary
pnpm dev         # Start development server
```

--------------------------------

### Run DotAgents Setup Directly

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/reference/cli.md

Starts the DotAgents setup process directly via the CLI command.

```bash
dotagents setup
```

--------------------------------

### Development Setup and Build

Source: https://github.com/aj47/dotagents-mono/blob/main/packages/mcp-whatsapp/README.md

Commands to install dependencies, build the project, and run in development mode.

```bash
# Install dependencies
pnpm install

# Build
pnpm build

# Run in development
pnpm dev
```

--------------------------------

### Re-run DotAgents Setup

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/reference/cli.md

Initiates the DotAgents setup process, which includes configuring authentication and other necessary settings. This can be run after the initial installation.

```bash
dotagents
/setup
```

--------------------------------

### Install and Launch Debian Package

Source: https://github.com/aj47/dotagents-mono/blob/main/LINUX_X64_VALIDATION.md

Install the generated Debian package using apt and launch the application. Verify successful installation and application behavior.

```bash
sudo apt install ./apps/desktop/dist/DotAgents_*_amd64.deb
dotagents
```

--------------------------------

### Clone and Install Project Dependencies

Source: https://github.com/aj47/dotagents-mono/blob/main/DEVELOPMENT.md

Use these commands to clone the repository, install Node.js version, and set up project dependencies.

```bash
git clone https://github.com/aj47/dotagents-mono.git
cd dotagents-mono
nvm use
pnpm install
pnpm build:shared
pnpm --filter @dotagents/desktop build-rs
pnpm dev
```

--------------------------------

### Install DotAgents Headless CLI from Source

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/reference/cli.md

Installs the headless DotAgents application from source, runs onboarding, and sets up a self-restarting daemon service if systemd is available. The CLI is installed at ~/.local/bin/dotagents.

```bash
curl -fsSL https://raw.githubusercontent.com/aj47/dotagents-mono/main/scripts/install.sh | DOTAGENTS_FROM_SOURCE=1 bash
```

--------------------------------

### Clone Repository and Install Dependencies

Source: https://github.com/aj47/dotagents-mono/blob/main/README.md

Clone the DotAgents Mono repository, set up the Node.js version, install pnpm dependencies, build the Rust component, and start the development server.

```bash
git clone https://github.com/aj47/dotagents-mono.git && cd dotagents-mono
nvm use
pnpm install && pnpm --filter @dotagents/desktop build-rs && pnpm dev
```

--------------------------------

### Install Dependencies and Build Packages

Source: https://github.com/aj47/dotagents-mono/blob/main/BUILDING.md

Run these commands to install project dependencies and build shared packages or specific desktop-related packages.

```bash
pnpm install
pnpm build:shared
pnpm --filter @dotagents/desktop build-rs
pnpm --filter @dotagents/desktop build
```

--------------------------------

### Clone and Run Dotagents Mono

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/getting-started/installation.md

Clone the repository, install dependencies, build the shared package, and start the desktop app in development mode. Ensure Node.js version is managed by nvm.

```bash
git clone https://github.com/aj47/dotagents-mono.git
cd dotagents-mono
nvm use                  # uses .nvmrc → Node 24.x
pnpm install
pnpm build:shared        # build the shared package first
pnpm dev                 # start the desktop app in dev mode
```

--------------------------------

### One-Line Install for macOS/Linux

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/getting-started/installation.md

Installs DotAgents using a curl command. Auto-detects OS and architecture, downloads the correct release artifact, and installs DotAgents.

```bash
# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/aj47/dotagents-mono/main/scripts/install.sh | bash
```

--------------------------------

### Install Dependencies and Build Linux x64 Release

Source: https://github.com/aj47/dotagents-mono/blob/main/LINUX_X64_VALIDATION.md

Run these commands from the repository root on the x64 machine to install dependencies and build the Linux x64 release artifacts.

```bash
corepack pnpm install --frozen-lockfile
corepack pnpm --filter @dotagents/desktop run build:linux:release:x64
```

--------------------------------

### Install Langfuse

Source: https://github.com/aj47/dotagents-mono/blob/main/apps/desktop/OBSERVABILITY.md

Install Langfuse as an optional dependency to enable observability features. Restart the app after installation.

```bash
pnpm add langfuse
```

--------------------------------

### Force Source Install (macOS/Linux)

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/getting-started/installation.md

Installs DotAgents from source instead of downloading a release. Use this option if you prefer to build from source.

```bash
# Force a source install instead of downloading a release (macOS / Linux)
curl -fsSL https://raw.githubusercontent.com/aj47/dotagents-mono/main/scripts/install.sh | DOTAGENTS_FROM_SOURCE=1 bash
```

--------------------------------

### Start Mobile App Development Server

Source: https://github.com/aj47/dotagents-mono/blob/main/apps/desktop/DEBUGGING.md

Run this command to start the mobile app's development server. Press 'w' to open the app in a web browser at localhost:8081.

```bash
pnpm dev:mobile  # Press 'w' for web → localhost:8081
```

--------------------------------

### Custom Install Directory (macOS/Linux)

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/getting-started/installation.md

Installs DotAgents to a custom directory. The default installation directory is ~/.dotagents.

```bash
# Custom install directory (default: ~/.dotagents)
curl -fsSL https://raw.githubusercontent.com/aj47/dotagents-mono/main/scripts/install.sh | DOTAGENTS_DIR=~/my-agents bash
```

--------------------------------

### Install Dependencies

Source: https://github.com/aj47/dotagents-mono/blob/main/apps/mobile/README.md

Install project dependencies using pnpm after setting the correct Node.js version.

```bash
nvm use
pnpm install
```

--------------------------------

### Force Source Install (Windows)

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/getting-started/installation.md

Installs DotAgents from source on Windows. Use this option if you prefer to build from source.

```powershell
# Force a source install on Windows
$env:DOTAGENTS_FROM_SOURCE = '1'; irm https://raw.githubusercontent.com/aj47/dotagents-mono/main/scripts/install.ps1 | iex
```

--------------------------------

### Markdown Configuration Example

Source: https://github.com/aj47/dotagents-mono/blob/main/PROTOCOL_ECOSYSTEM.md

Example of a Markdown file structure with optional frontmatter, used for system prompts and agent guidelines. The frontmatter uses a simple key-value format.

```markdown
---
# Optional simple frontmatter
---

# Markdown body content
This is the actual prompt/guidelines text.
```

--------------------------------

### POST /v1/operator/actions/mcp-start

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/reference/api.md

Starts the MCP services.

```APIDOC
## POST /v1/operator/actions/mcp-start

### Description
Start MCP services.

### Method
POST

### Endpoint
/v1/operator/actions/mcp-start
```

--------------------------------

### Example Chat Prompt Interaction

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/reference/cli.md

An example of a user query within the Dotagents CLI prompt. This demonstrates how to ask the agent to perform tasks like summarizing.

```text
❯ summarize the repo and suggest the next task
```

--------------------------------

### Start Docusaurus Docs Site

Source: https://github.com/aj47/dotagents-mono/blob/main/README.md

Run the Docusaurus development server to view the project's documentation site.

```bash
pnpm --filter docs-site start
```

--------------------------------

### Install Debian Package

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/getting-started/installation.md

Use this command to install the DotAgents .deb package. You will need root privileges.

```bash
sudo dpkg -i dotagents-*.deb
```

--------------------------------

### Install DotAgents on Windows

Source: https://github.com/aj47/dotagents-mono/blob/main/README.md

Installs DotAgents using PowerShell. This command downloads and executes the installation script on Windows machines.

```powershell
irm https://raw.githubusercontent.com/aj47/dotagents-mono/main/scripts/install.ps1 | iex
```

--------------------------------

### Install DotAgents on Linux/macOS

Source: https://github.com/aj47/dotagents-mono/blob/main/README.md

Installs DotAgents using a curl command. This is the primary installation method for Linux and macOS systems.

```bash
curl -fsSL https://raw.githubusercontent.com/aj47/dotagents-mono/main/scripts/install.sh | bash
```

--------------------------------

### One-Line Install for Windows PowerShell

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/getting-started/installation.md

Installs DotAgents using a PowerShell command. Auto-detects OS and architecture, downloads the correct release artifact, and installs DotAgents.

```powershell
# Windows PowerShell
irm https://raw.githubusercontent.com/aj47/dotagents-mono/main/scripts/install.ps1 | iex
```

--------------------------------

### JSON Configuration Example

Source: https://github.com/aj47/dotagents-mono/blob/main/PROTOCOL_ECOSYSTEM.md

Example of a JSON configuration file structure used within the .agents/ protocol. This format is used for general settings, MCP servers, and model presets.

```json
{
  "key": "value",
  "nested": { "key": "value" }
}
```

--------------------------------

### Bad Loop Prompt Example

Source: https://github.com/aj47/dotagents-mono/blob/main/apps/desktop/resources/bundled-skills/create-repeat-task/SKILL.md

Avoid restating cadence or harness mechanics in the prompt. This example is too conversational and lacks specificity for repeated runs.

```markdown
Every 20 minutes overnight, search my inbox and send me anything important.
```

--------------------------------

### Initial Theme Class Setup

Source: https://github.com/aj47/dotagents-mono/blob/main/apps/desktop/src/renderer/index.html

Calls the initialization function to set the theme class when the script loads.

```javascript
initThemeClass();
```

--------------------------------

### Install DotAgents Mobile App from Source

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/getting-started/installation.md

Clones the DotAgents mono repository, navigates into the directory, uses nvm to switch Node.js versions, and installs dependencies using pnpm.

```bash
git clone https://github.com/aj47/dotagents-mono.git
cd dotagents-mono
nvm use
pnpm install
```

--------------------------------

### Skill Markdown File Example

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/agents/skills.md

This is an example of a skill definition in markdown format. It includes frontmatter for metadata and a detailed workflow for the skill's execution.

```markdown
---
kind: skill
id: api-testing
name: API Testing
description: Test REST APIs with structured assertions and reporting
createdAt: 1709856000
updatedAt: 1709856000
source: local
---

# API Testing Skill

## Overview

This skill enables thorough API testing with structured reporting.

## Workflow

1. Analyze the API endpoint specification
2. Generate test cases covering:
   - Happy path (200 responses)
   - Error cases (4xx, 5xx)
   - Edge cases (empty inputs, large payloads)
   - Authentication scenarios
3. Execute tests using available HTTP tools
4. Report results in a structured format

## Output Format

For each test case, report:
- **Endpoint**: Method and URL
- **Status**: Pass/Fail
- **Expected**: What was expected
- **Actual**: What was received
- **Notes**: Any observations

## Best Practices

- Test idempotency for PUT/DELETE operations
- Verify response schemas match documentation
- Check rate limiting behavior
- Validate error message formats

```

--------------------------------

### GET /v1/operator/tunnel/setup

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/reference/api.md

Provides instructions and status for setting up the Cloudflare Tunnel.

```APIDOC
## GET /v1/operator/tunnel/setup

### Description
Tunnel setup instructions/status.

### Method
GET

### Endpoint
/v1/operator/tunnel/setup
```

--------------------------------

### Mobile Development Commands

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/development/setup.md

Starts the Metro bundler for mobile development or builds for iOS, Android, and web platforms.

```bash
pnpm --filter @dotagents/mobile start    # Start Metro bundler
pnpm --filter @dotagents/mobile ios      # iOS (requires Xcode)
pnpm --filter @dotagents/mobile android  # Android (requires Android Studio)
pnpm --filter @dotagents/mobile web      # Web
```

--------------------------------

### SKILL.md Format Example

Source: https://github.com/aj47/dotagents-mono/blob/main/apps/desktop/resources/bundled-skills/agent-skill-creation/SKILL.md

This is the standard format for a SKILL.md file, including YAML frontmatter and markdown sections for instructions.

```markdown
---
name: skill-name-in-kebab-case
description: "Concise description of what this skill enables. Include trigger phrases like 'When the user asks to...'"
---

# Skill Title

## Overview
Brief explanation of what this skill does and when to use it.

## Workflows
Step-by-step instructions for completing tasks.

## Best Practices
Guidelines and tips for using this skill effectively.

## Dependencies (optional)
Required tools or packages.

```

--------------------------------

### MCP Server Configuration Example

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/tools/mcp.md

Configure various MCP servers including filesystem, github, and exa with their respective commands, arguments, environment variables, and transport types.

```json
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/you/Documents"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_..."
      }
    },
    "exa": {
      "transport": "streamableHttp",
      "url": "https://mcp.exa.ai/mcp"
    }
  }
}
```

--------------------------------

### Run Docs Coverage and Build Site

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/development/docs-coverage.md

Execute this command to verify remote server routes and build the documentation site. This ensures that all Fastify routes are documented and that the documentation site is up-to-date.

```bash
pnpm docs:coverage
pnpm --filter docs-site build
```

--------------------------------

### Fire-on-Startup Task

Source: https://github.com/aj47/dotagents-mono/blob/main/apps/desktop/resources/bundled-skills/create-repeat-task/examples.md

Runs at a specified interval and also executes once immediately when the application boots.

```markdown
---
kind: task
id: morning-briefing
name: Morning Briefing
enabled: true
intervalMinutes: 240
runOnStartup: true
---

On each run, summarize new emails and calendar events since the previous task run. Return only urgent items and the next concrete action.
```

--------------------------------

### Example Critique Rubric for Agent Tasks

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/agents/repeat-tasks.md

Define a clear rubric within the task prompt to guide the agent's built-in critic. This rubric specifies evaluation criteria, evidence requirements, and pass/fail conditions.

```markdown
Critique rubric:

- Fail if any title claim is not supported by an analytics note, transcript quote, or audience comment.
- Fail if the thumbnail concept cannot be drawn from real assets we have.
- Fail if the recommendation repeats the previous run without a material new reason.
- Pass with caveat if the output is useful but one evidence item is weak.
- Return only: verdict, top blocker, artifact path reviewed, and one correction.
```

--------------------------------

### Example Skill Discovery

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/agents/skills.md

When an agent initializes, its system prompt lists available skills and their descriptions. This helps the agent understand its capabilities.

```text
Available Skills:
- api-testing: Test REST APIs with structured assertions and reporting
- document-processing: Create, edit, and analyze .docx files
```

--------------------------------

### Custom Install Directory (Windows)

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/getting-started/installation.md

Installs DotAgents to a custom directory on Windows. The default installation directory is ~/.dotagents.

```powershell
# Custom install directory on Windows
$env:DOTAGENTS_DIR = "$HOME\dotagents"; irm https://raw.githubusercontent.com/aj47/dotagents-mono/main/scripts/install.ps1 | iex
```

--------------------------------

### Agent Configuration File Example

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/getting-started/first-agent.md

Configure agent's tools, models, and connections using a JSON file. This file should be placed at ~/.agents/agents/<agent-id>/config.json.

```json
{
  "toolConfig": {
    "enabledServers": ["github", "filesystem"],
    "disabledTools": ["filesystem:delete_file"]
  },
  "modelConfig": {
    "provider": "openai",
    "model": "gpt-5.4-mini"
  }
}

```

--------------------------------

### Make AppImage Executable and Launch

Source: https://github.com/aj47/dotagents-mono/blob/main/LINUX_X64_VALIDATION.md

Make the AppImage executable and launch it directly. Verify that the application launches correctly in the desktop session.

```bash
chmod +x apps/desktop/dist/DotAgents-*-x64.AppImage
./apps/desktop/dist/DotAgents-*-x64.AppImage
```

--------------------------------

### Example Skill File Organization

Source: https://github.com/aj47/dotagents-mono/blob/main/apps/desktop/resources/bundled-skills/agent-skill-creation/SKILL.md

This illustrates a typical directory structure for an agent skill, including the required SKILL.md and optional supporting files.

```tree
skill-name/
├── SKILL.md           # Required: Main skill instructions
├── reference.md       # Optional: Detailed reference material
├── examples/          # Optional: Example files
│   ├── example1.md
│   └── example2.md
├── scripts/           # Optional: Helper scripts
│   └── helper.py
└── templates/         # Optional: Templates for common tasks
    └── template.md

```

--------------------------------

### GET /v1/operator/whatsapp

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/reference/api.md

Gets the status of the WhatsApp MCP and operator.

```APIDOC
## GET /v1/operator/whatsapp

### Description
WhatsApp MCP/operator status.

### Method
GET

### Endpoint
/v1/operator/whatsapp
```

--------------------------------

### Agent Configuration (`agent.md`) Example

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/agents/profiles.md

Shows the structure of an `agent.md` file, including frontmatter fields for agent metadata and the system prompt body.

```markdown
---
kind: agent
id: code-reviewer
name: code-reviewer
displayName: Code Reviewer
description: Reviews TypeScript changes for bugs and security issues
enabled: true
role: chat-agent
connection-type: internal
guidelines: Prioritize correctness, security, and actionable feedback.
---

You are an expert code reviewer specializing in TypeScript, React, and Electron.

When reviewing changes:

- Focus on behavior, security, and maintainability
- Reference concrete files and lines when possible
- Separate blocking issues from optional suggestions
```

--------------------------------

### GET /v1/operator/remote-server

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/reference/api.md

Gets a snapshot of the remote server's status and configuration.

```APIDOC
## GET /v1/operator/remote-server

### Description
Remote server status/config snapshot.

### Method
GET

### Endpoint
/v1/operator/remote-server
```

--------------------------------

### Make AppImage Executable and Run

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/getting-started/installation.md

Use this command to make the AppImage executable and then run it. Ensure you replace `DotAgents-*.AppImage` with the actual filename.

```bash
chmod +x DotAgents-*.AppImage && ./DotAgents-*.AppImage
```

--------------------------------

### Uninstall Linux One-Line Installer

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/getting-started/installation.md

Removes DotAgents application files and the launcher if installed via the one-line script.

```bash
rm -rf ~/.dotagents
rm -f ~/.local/bin/dotagents
```

--------------------------------

### Agent File Layout Example

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/agents/profiles.md

Illustrates the directory structure for an agent, including `agent.md` for identity and `config.json` for detailed settings.

```text
.agents/
`-- agents/
    `-- code-reviewer/
        |-- agent.md      # identity, role, connection type, system prompt
        `-- config.json   # tool, model, skill, and connection details
```

--------------------------------

### Example MCP Servers Configuration

Source: https://github.com/aj47/dotagents-mono/blob/main/PROTOCOL_ECOSYSTEM.md

Illustrates how to configure multiple MCP servers within the DotAgents configuration, specifying transport types and necessary details for each server.

```json
{
  "mcpServers": {
    "github": {
      "transport": "stdio",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": { "GITHUB_PERSONAL_ACCESS_TOKEN": "..." }
    },
    "exa": {
      "transport": "streamableHttp",
      "url": "https://mcp.exa.ai/mcp"
    }
  }
}
```

--------------------------------

### Start Metro Bundler

Source: https://github.com/aj47/dotagents-mono/blob/main/apps/mobile/README.md

Start the Metro bundler for the mobile application. This allows you to select a platform in the UI to run the app.

```bash
pnpm --filter @dotagents/mobile start
```

--------------------------------

### Build Documentation Site

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/development/apps-and-packages.md

Builds the documentation site, typically for previewing or deployment.

```bash
pnpm --filter docs-site build
```

--------------------------------

### Log Main Window Show Event Details

Source: https://github.com/aj47/dotagents-mono/blob/main/docs/debug/main-window-hide.md

Log the activation policy and dock visibility when the main window is shown to understand its state upon becoming visible.

```typescript
win.on("show", () => {
  logApp("Main window shown", {
    activationPolicy: app.getActivationPolicy?.(),
    dockVisible,
  });
});
```

--------------------------------

### Initialize Theme Class

Source: https://github.com/aj47/dotagents-mono/blob/main/apps/desktop/src/renderer/index.html

Initializes the theme by applying the current preference. This function should be called on application startup.

```javascript
function initThemeClass() {
  applyTheme();
}
```

--------------------------------

### Install acpx and @openai/codex with pnpm

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/reference/cli.md

Installs the 'acpx' and '@openai/codex' packages globally using pnpm. This is required for specific Codex integration modes.

```bash
corepack enable
corepack prepare pnpm@9 --activate
pnpm add -g acpx@latest
pnpm add -g @openai/codex@latest
```

--------------------------------

### Build Desktop Application

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/development/build-release-deploy.md

Runs desktop typecheck, tests, Electron build, and Rust build.

```bash
pnpm --filter @dotagents/desktop build
```

--------------------------------

### Troubleshooting: Windows Electron Dependencies

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/development/setup.md

Installs Electron dependencies on Windows, ignoring scripts initially and then executing a specific command to install app dependencies.

```powershell
pnpm install --ignore-scripts
pnpm.cmd -C apps/desktop exec electron-builder install-app-deps
```

--------------------------------

### Release Desktop Application

Source: https://github.com/aj47/dotagents-mono/blob/main/BUILDING.md

Navigate to the desktop application directory and execute the release command.

```bash
cd apps/desktop
pnpm release
```

--------------------------------

### Enable and Prepare pnpm

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/development/setup.md

Enables Corepack for package management and prepares a specific version of pnpm. This is a required setup step.

```bash
corepack enable
corepack prepare pnpm@9 --activate
```

--------------------------------

### Configure MCP Servers

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/getting-started/quickstart.md

Add a filesystem MCP server to enable your agent to read and write files. Ensure the command and arguments are correctly set for your environment.

```json
{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/you/Documents"]
    }
  }
}
```

--------------------------------

### Run Documentation Coverage

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/development/apps-and-packages.md

Use this command to check the documentation coverage for the project.

```bash
pnpm docs:coverage
```

--------------------------------

### Knowledge Note Example

Source: https://github.com/aj47/dotagents-mono/blob/main/PROTOCOL_ECOSYSTEM.md

Example of a knowledge note in Markdown format. Features frontmatter with metadata such as kind, id, title, context, and tags, followed by a markdown body for detailed content.

```markdown
---
kind: note
id: project-architecture
title: Project Architecture
context: auto
updatedAt: 1234567890
tags: architecture, backend
summary: Service-oriented Electron app with layered .agents config.
---

## Details

Longer-form markdown content goes here.
```

--------------------------------

### Using a Companion Skill in a Task Prompt

Source: https://github.com/aj47/dotagents-mono/blob/main/apps/desktop/resources/bundled-skills/create-repeat-task/SKILL.md

This example shows how to invoke a companion skill within a task prompt, specifying its purpose, data paths, and output requirements.

```markdown
On each run, use the `youtube-thumbnail` skill to improve one thumbnail candidate for the current video. Read and update `~/.agents/tasks/video-packaging/thumbnail-board.md`; save generated assets under `~/.agents/tasks/video-packaging/assets/thumbnails/`; return the best current direction and next lane.
```

--------------------------------

### Git Commit Message Guidelines Example

Source: https://github.com/aj47/dotagents-mono/blob/main/apps/desktop/resources/bundled-skills/agent-skill-creation/examples.md

An example of a skill focused on providing guidelines for writing clear and conventional git commit messages. It outlines the format, types, and rules for good commit messages.

```markdown
---
name: git-commit-messages
description: "Guidelines for writing clear, conventional git commit messages. Use when creating commits or reviewing commit messages."
---

# Git Commit Message Guidelines

## Format

```
<type>(<scope>): <subject>

<body>

<footer>
```

## Types
- **feat**: New feature
- **fix**: Bug fix
- **docs**: Documentation only
- **style**: Formatting, no code change
- **refactor**: Code restructuring
- **test**: Adding tests
- **chore**: Maintenance tasks

## Rules
1. Subject line ≤ 50 characters
2. Use imperative mood ("Add feature" not "Added feature")
3. Don't end subject with period
4. Wrap body at 72 characters
5. Explain what and why, not how

## Examples

Good:
```
feat(auth): add OAuth2 support for Google login

Implements OAuth2 flow for Google authentication.
Includes token refresh handling and secure storage.

Closes #123
```
```

--------------------------------

### Example Repeat Task Frontmatter and Content

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/agents/repeat-tasks.md

This is an example of a repeat task's frontmatter metadata and its associated content. It defines task properties like ID, name, and execution interval, along with instructions for the agent.

```markdown
---
kind: task
id: youtube-growth-lab
name: YouTube Growth Lab
enabled: true
intervalMinutes: 60
profileId: main-agent
runOnStartup: true
continueInSession: true
critiquePass: true
criticProfileId: strict-critic
---

Review recent channel notes, analytics exports, and audience evidence. Produce:

- Three title candidates
- Three hook candidates
- One thumbnail concept
- One evidence note that explains what changed since the last run

Write the latest artifact to `~/.agents/tasks/youtube-growth-lab/latest.md`.
The critique pass should reject unsupported claims, vague packaging, and any draft that does not cite the evidence it used.
```

--------------------------------

### Build, Typecheck, and Test @dotagents/core

Source: https://github.com/aj47/dotagents-mono/blob/main/packages/core/README.md

Run these commands from the repository root to manage the @dotagents/core package.

```bash
pnpm --filter @dotagents/core build
pnpm --filter @dotagents/core typecheck
pnpm --filter @dotagents/core test
```

--------------------------------

### GET /v1/operator/updater

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/reference/api.md

Retrieves the status of the operator updater.

```APIDOC
## GET /v1/operator/updater

### Description
Updater status.

### Method
GET

### Endpoint
/v1/operator/updater
```

--------------------------------

### GET /v1/operator/discord/logs

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/reference/api.md

Fetches logs for the Discord integration.

```APIDOC
## GET /v1/operator/discord/logs

### Description
Discord logs.

### Method
GET

### Endpoint
/v1/operator/discord/logs
```

--------------------------------

### Create a Knowledge Note Directory

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/agents/knowledge-notes.md

Use this command to create a new directory for your knowledge notes within the agent's knowledge base. This sets up the structure for organizing notes.

```bash
mkdir -p ~/.agents/knowledge/coding-standards
```

--------------------------------

### Verify Artifacts in apps/desktop/dist

Source: https://github.com/aj47/dotagents-mono/blob/main/LINUX_X64_VALIDATION.md

Navigate to the distribution directory and run these commands to verify the generated artifacts, including checksums and file types.

```bash
cd apps/desktop/dist
sha256sum -c SHA256SUMS
ls -lh DotAgents-*-x64.AppImage DotAgents_*_amd64.deb
file DotAgents-*-x64.AppImage DotAgents_*_amd64.deb
```

--------------------------------

### GET /v1/operator/discord

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/reference/api.md

Retrieves the status of the Discord integration.

```APIDOC
## GET /v1/operator/discord

### Description
Discord integration status.

### Method
GET

### Endpoint
/v1/operator/discord
```

--------------------------------

### GET /v1/operator/tunnel

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/reference/api.md

Retrieves the status of the Cloudflare Tunnel.

```APIDOC
## GET /v1/operator/tunnel

### Description
Cloudflare Tunnel status.

### Method
GET

### Endpoint
/v1/operator/tunnel
```

--------------------------------

### GET /v1/operator/conversations

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/reference/api.md

Retrieves a list of operator conversations.

```APIDOC
## GET /v1/operator/conversations

### Description
Operator conversation list.

### Method
GET

### Endpoint
/v1/operator/conversations
```

--------------------------------

### Basic MCP Server Configuration

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/configuration/mcp-servers.md

Example of a basic MCP server configuration within the mcpServers object in a JSON configuration file.

```json
{
  "mcpServers": {
    "server-name": {
      "transport": "stdio",
      "command": "npx",
      "args": ["-y", "package-name"],
      "env": {}
    }
  }
}
```

--------------------------------

### POST /v1/operator/whatsapp/connect

Source: https://github.com/aj47/dotagents-mono/blob/main/docs-site/docs/reference/api.md

Connects or starts the WhatsApp integration.

```APIDOC
## POST /v1/operator/whatsapp/connect

### Description
Connect/start WhatsApp integration.

### Method
POST

### Endpoint
/v1/operator/whatsapp/connect
```