### Manage Clawdcursor Guides

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/index.html

Commands to manage and install clawdcursor guides. Use 'lint' to check your app configuration and 'submit' to upload your own guides.

```bash
clawdcursor guides available
clawdcursor guides install youtube
clawdcursor guides list
clawdcursor guides lint my-app.json
clawdcursor guides submit my-app.json
```

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

### CLI: Install and Setup Commands

Source: https://github.com/amrdab/clawdcursor/blob/main/README.md

Commands for managing desktop-control consent, granting macOS permissions, verifying configurations, and checking readiness status.

```bash
clawdcursor consent         Manage desktop-control consent (--accept / --revoke / --status)
```

```bash
clawdcursor grant           Grant macOS permissions (interactive, macOS only)
```

```bash
clawdcursor doctor          Verify permissions, configure AI provider + models
```

```bash
clawdcursor status          Readiness check (consent, permissions, AI config)
```

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

### Local Development Setup

Source: https://github.com/amrdab/clawdcursor/blob/main/CONTRIBUTING.md

Clone the repository, install dependencies, and set up the project for local development. This includes building the project and linking the global binary.

```shell
git clone https://github.com/AmrDab/clawdcursor.git
cd clawdcursor
npm install
npm run setup              # builds, links the global `clawdcursor` binary, builds native helpers on macOS
```

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

### Development Setup Commands

Source: https://github.com/amrdab/clawdcursor/blob/main/README.md

Commands for cloning the repository, installing dependencies, building the project, running tests, linting, type checking, and linking the global shim.

```bash
git clone https://github.com/AmrDab/clawdcursor.git
```

```bash
cd clawdcursor
```

```bash
npm install
```

```bash
npm run build       # tsc + postbuild
```

```bash
npm test            # vitest
```

```bash
npm run lint        # eslint
```

```bash
npm run typecheck   # tsc --noEmit
```

```bash
npm link            # global `clawdcursor` shim (Unix) — use Admin shell on Windows
```

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

### CLI: Guides Marketplace Commands

Source: https://github.com/amrdab/clawdcursor/blob/main/README.md

Commands for managing the guides cache, including listing, installing, refreshing, removing, and cleaning guides.

```bash
clawdcursor guides list                What's cached + ratings
```

```bash
clawdcursor guides info <app>          Cache metadata for one app
```

```bash
clawdcursor guides available           Browse the public registry
```

```bash
clawdcursor guides install <app>       Pre-warm one (or --all for offline prep)
```

```bash
clawdcursor guides refresh <app>       Force re-fetch
```

```bash
clawdcursor guides remove <app>        Evict from cache
```

```bash
clawdcursor guides clean               Wipe cache
```

```bash
clawdcursor guides lint <file>         Validate a local guide
```

```bash
clawdcursor guides submit <file>       Lint + print PR instructions
```

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

### Clawdcursor Guides CLI Commands

Source: https://github.com/amrdab/clawdcursor/blob/main/CHANGELOG.md

Provides commands for managing app guides, including listing, installing, refreshing, removing, cleaning, linting, and submitting guides.

```bash
`clawdcursor guides` CLI rewritten: `list`, `info <app>`, `available`, `install <app>` / `install --all`, `refresh <app>`, `remove <app>`, `clean`, `lint <file>`, `submit <file>` (lints + prints PR instructions).
```

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

### Install and Setup Clawdcursor CLI

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/index.html

Essential commands for initial setup and authorization of the Clawdcursor CLI. Run 'doctor' to verify permissions and AI configuration.

```bash
clawdcursor consent
clawdcursor grant
clawdcursor doctor
clawdcursor status
```

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

### Manage Clawdcursor Guides

Source: https://github.com/amrdab/clawdcursor/blob/main/README.md

Command-line interface for interacting with the Clawdcursor guide marketplace. Use these commands to browse, install, list, and manage guides for various applications.

```bash
clawdcursor guides available             # browse the public registry
```

```bash
clawdcursor guides install youtube       # pre-warm cache for one app
```

```bash
clawdcursor guides list                  # show cached + ratings
```

```bash
clawdcursor guides info youtube          # details for one cached guide
```

```bash
clawdcursor guides refresh youtube       # force re-fetch
```

```bash
clawdcursor guides submit my-app.json    # lint + print PR instructions
```

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

### CSS for Install Card Header

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/index.html

Styles for the header of an install card, used in quick start guides, which can contain method tabs and OS toggles.

```css
/* Install card (Quick Start) — method tabs left, OS toggle right */
.install-card { position: relative; }
.install-hd { flex-wrap: wrap; }
```

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

### Start Agent

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/MACOS-SETUP.md

Initiate the agent process using the 'npm start' command.

```bash
# Start agent
npm start
```

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

### Install @bright-fish/node-ui-automation Package

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/ACCESSIBILITY-RESEARCH.md

This command installs the @bright-fish/node-ui-automation package. It's recommended to try this package if it installs and works on Node 20+ before committing to other solutions.

```bash
npm install @bright-fish/node-ui-automation
```

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

### Example App Guide JSON Format

Source: https://github.com/amrdab/clawdcursor/blob/main/guides/README.md

This JSON structure defines context for an application guide, including process names, domain hints, keyboard shortcuts, workflows, layout descriptions, and usage tips. It is used to enrich the LLM's understanding of an application.

```json
{
  "app": "Microsoft Excel",
  "processNames": ["EXCEL", "excel"],
  "domainHints": ["sheets.google.com"],
  "shortcuts": {
    "new_workbook": "Ctrl+N",
    "save": "Ctrl+S"
  },
  "workflows": {
    "create_table": "Click cell A1. Type headers with Tab between columns. Enter for next row.",
    "save_as": "Press Ctrl+Shift+S. Navigate to folder. Type filename. Click Save."
  },
  "layout": {
    "ribbon": "Top toolbar with tabs (Home, Insert, Page Layout, etc.)",
    "workspace": "Grid of cells below the ribbon — this is where you type data"
  },
  "tips": [
    "Tab moves right, Enter moves down. Shift+Tab moves left.",
    "For simple tables, type directly into cells. Don't use Insert > Table."
  ]
}
```

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

### Window Tool Example

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/internal/v0.9-readme-building-blocks.md

Manage application and window lifecycles with the window tool. This example opens the 'Notepad' application.

```python
window({"action":"open_app","name":"Notepad"})
```

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

### Remote Guide Loader Module

Source: https://github.com/amrdab/clawdcursor/blob/main/CHANGELOG.md

Fetches app guides with timeout, conditional GET via ETag, and stale-while-revalidate. Used for loading community-curated app knowledge.

```typescript
src/llm/knowledge/remote-loader.ts — `fetchGuide(app)` with timeout, conditional GET via ETag, stale-while-revalidate.
```

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

### Lint App Guide with Standalone Script

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/app-guides/index.html

Alternatively, use the standalone Node.js script from the guides repository to lint your app guide JSON file.

```bash
# or via the standalone script in the guides repo
node scripts/lint-guide.mjs my-app.json
```

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

### Clawdcursor Installation Comments

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/index.html

Provides descriptive comments for different installation methods. These comments explain the purpose and scope of each installation approach.

```javascript
const INSTALL_COMMENTS = {
  oneliner: '# Works everywhere. Installs Node if needed, builds, links the global shim.',
  npm: '# Simplest — any OS. (macOS: also run `clawdcursor grant` for the native helper.)',
  source: '# Clone, build, link — for hacking on clawdcursor itself.'
};
```

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

### Agent Workflow for Loading Guides

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/guide-marketplace.md

Illustrates the process an agent follows to detect an application, prefetch its guide, and load it, including checks against various cache locations and fallback mechanisms.

```text
Agent run                                              Local              Remote
─────────                                              ─────              ──────
preprocess(task, ctx)
  └─ detectApp(activeWindow.title) → "youtube"
  └─ prefetchGuideForApp("youtube")  ─── async ───────────────────────►  GET /guides/youtube.json
                                                                          │
loadGuide("youtube")                                                      │
  ├─ in-memory cache?         no                                          │
  ├─ ~/.clawdcursor/ui-knowledge/youtube.json?  no  (learn_app override)  │
  ├─ ~/.clawdcursor/guide-cache/youtube.json?   no  (first encounter)     │
  └─ src/llm/knowledge/guides/youtube.json?     no  (not in minimum core) │
  → null                                                                   │
                                                                          ▼
                                                                       lintGuide(payload)
                                                                          │ pass
                                                                          ▼
                                                                       setCached("youtube", …)
                                                                       (TTL 7d, LRU 50)

Next task involving YouTube
  loadGuide("youtube")
  ├─ in-memory cache? no
  ├─ user-override?   no
  └─ ~/.clawdcursor/guide-cache/youtube.json? YES  ← from prefetch
     → adopt + lint defense-in-depth → return guide → ★ render to prompt
```

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

### Clawdcursor Installation Commands

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/index.html

Provides installation commands for Clawdcursor across different operating systems and methods. Includes options for one-liner installation via PowerShell or curl, npm package installation, and building from source.

```shell
// Install card: method (oneliner/npm/source) × OS (win/unix) const INSTALL_CMDS = { 'oneliner|win': 'powershell -c "irm https://clawdcursor.com/install.ps1 | iex"', 'oneliner|unix': 'curl -fsSL https://clawdcursor.com/install.sh | bash', 'npm|win': 'npm i -g clawdcursor', 'npm|unix': 'npm i -g clawdcursor', 'source|win': 'git clone https://github.com/AmrDab/clawdcursor.git && cd clawdcursor && npm i && npm run build && npm link', 'source|unix': 'git c
```

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

### LLM Preprocessor System Prompt Examples

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/internal/agnostic-audit-report.md

Example apps and URLs in the LLM preprocessor system prompt. This list is duplicated effort and should be consolidated with the alias table and URL-shortcut table.

```text
Edge/Chrome/Firefox/Brave/Safari, Gmail, GitHub, Notion, Codepen, Twitter, Wikipedia, Amazon, Reddit, YouTube…
```

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

### Example Toolbox Tool Usage

Source: https://github.com/amrdab/clawdcursor/blob/main/README.md

Demonstrates how to use different tools from the Clawdcursor toolbox with their respective actions and parameters.

```javascript
computer({ action: "key", combo: "mod+s" })          // resolves to Cmd+S / Ctrl+S
accessibility({ action: "invoke", name: "Send" })
window({ action: "open_app", name: "Outlook" })
system({ action: "ocr" })                            // OS-level OCR, no LLM vision
task({ instruction: "open Notepad and type hello" }) // delegates to the pipeline
```

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

### Start Agent with Ollama

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/MACOS-SETUP.md

Start the agent process using npm, specifically configured to use Ollama as the provider.

```bash
# Start with Ollama (free)
npm start -- --provider ollama
```

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

### Clawdcursor Installation Commands

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/index.html

Defines installation commands for various methods (oneliner, npm, source) and operating systems (Windows, macOS, Linux). Use this to display the correct installation command based on user selection.

```javascript
const INSTALL_CMDS = {
  oneliner: {
    win: 'winget install --id AmrDab.clawdcursor',
    mac: 'brew install amrdab/tap/clawdcursor',
    linux: 'sudo apt install clawdcursor'
  },
  npm: {
    any: 'npm install -g clawdcursor'
  },
  source: {
    any: 'git clone https://github.com/AmrDab/clawdcursor.git && cd clawdcursor && npm i && npm run build && npm link'
  }
};
```

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

### Computer Tool Example

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/internal/v0.9-readme-building-blocks.md

Use the computer tool for raw mouse, keyboard, and pixel perception actions. This example demonstrates pressing a key combination.

```python
computer({"action":"key","combo":"mod+s"})
```

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

### System Tool Example

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/internal/v0.9-readme-building-blocks.md

Perform system-level operations like clipboard access and OCR using the system tool. This example initiates an OCR scan.

```python
system({"action":"ocr"})
```

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

### Install Ollama and Pull Model

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/MACOS-SETUP.md

Installs Ollama via Homebrew and pulls the 'qwen2.5:7b' model for local AI processing.

```bash
# Install Ollama
brew install ollama

# Pull the model
ollama pull qwen2.5:7b
```

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

### Install clawdcursor on Windows

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/internal/v0.9.3-release-body-draft.md

Use this command to perform a fresh installation of clawdcursor on Windows systems.

```powershell
irm https://clawdcursor.com/install.ps1 | iex
```

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

### ClawdCursor Guides GitHub Repository Structure

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/guide-marketplace.md

Details the layout of the ClawdCursor Guides GitHub repository, including the location of guide files, metadata aggregation scripts, and CI/CD workflows.

```text
clawdcursor-guides/
├── README.md                Submission + browse listing
├── CONTRIBUTING.md          PR flow + schema + linter rules
├── CODEOWNERS               Required reviewers
├── LICENSE                  MIT
├── youtube.json             ← guides at repo root, NOT under guides/
├── gmail.json
├── outlook.json
├── slack.json
├── …
├── index.json               Aggregated metadata (auto-generated nightly)
├── scripts/
│   ├── lint-guide.mjs       Standalone Node linter (vendored from clawdcursor)
│   └── aggregate-index.mjs  Reads vote-issue reactions → index.json
└── .github/
    ├── workflows/
    │   ├── validate.yml     Lints PR-changed guides
    │   └── aggregate.yml    Nightly + on-merge index rebuild
    ├── ISSUE_TEMPLATE/
    │   ├── vote.yml         "vote: <app>" template (👍/👎 → ratings)
    │   └── bug.yml          Report broken guides
    └── PULL_REQUEST_TEMPLATE.md
```

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

### Install Node.js using Homebrew

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/MACOS-SETUP.md

Installs Node.js using the Homebrew package manager, which is the recommended method for macOS.

```bash
# Using Homebrew (recommended)
brew install node

# Or download from https://nodejs.org
```

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

### Task Tool Example

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/internal/v0.9-readme-building-blocks.md

Delegate natural-language sub-instructions to the full pipeline using the task tool. This example sets an instruction to reply to an email.

```python
task({"instruction":"Reply to Sarah's email"})
```

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

### Start Clawd Cursor Agent with Options

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/MACOS-SETUP.md

Starts the Clawd Cursor agent with various command-line options, including specifying the AI provider (e.g., Ollama), enabling debug screenshots, or setting a custom port.

```bash
# With Ollama (free, local)
npm start -- --provider ollama

# With debug screenshots
npm start -- --debug

# Custom port
npm start -- --port 4000
```

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

### App Guides Index Rendering Logic

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/app-guides/index.html

This JavaScript code is responsible for fetching, parsing, and rendering the list of app guides on the documentation page. It includes functionality for filtering, searching, and displaying guide metadata.

```javascript
(function () {
  var listEl = document.getElementById('list');
  var countEl = document.getElementById('meta-count');
  var schemaEl = document.getElementById('meta-schema');
  var genEl = document.getElementById('meta-generated');
  var search = document.getElementById('search');
  var trustBtns = document.querySelectorAll('.filter-btn');
  var allGuides = [];
  var activeTrust = 'all';
  var activeQuery = '';

  function escapeHtml(s) {
    return String(s == null ? '' : s).replace(/["&<>'\\]/g, function (c) {
      return { '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' }[c];
    });
  }

  function fmtAge(iso) {
    if (!iso) return 'unknown';
    var ms = Date.now() - new Date(iso).getTime();
    if (isNaN(ms)) return 'unknown';
    var s = Math.floor(ms / 1000);
    if (s < 60) return s + 's ago';
    if (s < 3600) return Math.floor(s / 60) + 'm ago';
    if (s < 86400) return Math.floor(s / 3600) + 'h ago';
    return Math.floor(s / 86400) + 'd ago';
  }

  function render() {
    var q = activeQuery.toLowerCase();
    var rows = allGuides.filter(function (g) {
      if (activeTrust !== 'all' && g.trust !== activeTrust) return false;
      if (!q) return true;
      return g.app.toLowerCase().includes(q) || (g.submitter && g.submitter.toLowerCase().includes(q));
    });

    if (rows.length === 0) {
      listEl.innerHTML = '<div class="empty">No guides match.</div>';
      return;
    }

    var html = rows.map(function (g) {
      var trustClass = 'trust-' + (g.trust || 'community');
      var upvotes = g.upvotes || 0;
      var downvotes = g.downvotes || 0;
      var votesHtml = (upvotes + downvotes) > 0 ? '<span class="up">▲ ' + upvotes + '</span> <span class="down">▼ ' + downvotes + '</span>' : '<span style="color:var(--text3)">— no votes</span>';
      var sourceLink = 'https://github.com/AmrDab/clawdcursor-guides/blob/main/' + encodeURIComponent(g.app) + '.json';
      var voteLink = 'https://github.com/AmrDab/clawdcursor-guides/issues?q=' + encodeURIComponent('vote: ' + g.app);

      return '<div class="guide-card">' +
             '<div class="guide-card-main">' +
             '<div class="guide-name">' +
             '<a href="./' + encodeURIComponent(g.app) + '.json">' +
             escapeHtml(g.app) + '</a>' +
             '<span class="trust-badge ' + trustClass + '">' + escapeHtml(g.trust || 'community') + '</span>' +
             '</div>' +
             '<div class="guide-meta-line">' +
             '<span>v' + escapeHtml(g.version || '?') + '</span>' +
             (g.submitter ? '<span>by ' + escapeHtml(g.submitter) + '</span>' : '') +
             '<span class="votes">' + votesHtml + '</span>' +
             '</div>' +
             '</div>' +
             '<div class="guide-card-actions">' +
             '<a class="guide-action-btn" href="./' + encodeURIComponent(g.app) + '.json">JSON</a>' +
             '<a class="guide-action-btn" href="' + sourceLink + '" target="_blank" rel="noopener">Source</a>' +
             '<a class="guide-action-btn" href="' + voteLink + '" target="_blank" rel="noopener">Vote</a>' +
             '</div>' +
             '</div>';
    }).join('');

    listEl.innerHTML = html;
  }

  function attachFilters() {
    search.addEventListener('input', function () {
      activeQuery = search.value;
      render();
    });

    trustBtns.forEach(function (b) {
      b.addEventListener('click', function () {
        trustBtns.forEach(function (x) { x.classList.remove('active'); });
        b.classList.add('active');
        activeTrust = b.getAttribute('data-trust');
        render();
      });
    });
  }

  fetch('./index.json', { cache: 'no-cache' })
    .then(function (r) { if (!r.ok) throw new Error('HTTP ' + r.status); return r.json(); })
    .then(function (data) {
      var guidesObj = (data && data.guides) || {};
      allGuides = Object.keys(guidesObj).sort().map(function (k) {
        return Object.assign({ app: k }, guidesObj[k]);
      });
      countEl.textContent = allGuides.length;
      schemaEl.textContent = data.schemaVersion || '?';
      genEl.textContent = fmtAge(data.generatedAt);
      attachFilters();
      render();
    })
    .catch(function (err) {
      listEl.innerHTML = '<div class="err">Could not load the registry index: ' + escapeHtml(err.message || String(err)) + '. ' + 'Try <a href="./index.json">opening index.json directly</a> or visit the ' + '<a href="https://github.com/AmrDab/clawdcursor-guides">source repo on GitHub</a>.</div>';
    });
})();
```

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

### Install AT-SPI for Linux Fedora

Source: https://github.com/amrdab/clawdcursor/blob/main/SKILL.md

Install the necessary Python packages for AT-SPI accessibility support on Fedora Linux.

```bash
sudo dnf install python3-gobject atspi
```

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

### Render Clawdcursor Installation UI

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/index.html

Renders the installation command and comment based on selected method and OS. It also updates the active tab styles and manages the visibility of OS-specific options.

```javascript
let _instM = 'oneliner',
    _instO = 'win';

function renderInstall() {
  const cmd = document.getElementById('inst-cmd');
  const comment = document.getElementById('inst-comment');
  if (!cmd || !comment) return;
  cmd.textContent = INSTALL_CMDS[_instM + '|' + _instO];
  comment.textContent = INSTALL_COMMENTS[_instM];
  document.querySelectorAll('.inst-tab').forEach(t => t.classList.toggle('active', t.dataset.m === _instM));
  document.querySelectorAll('.inst-os-tab').forEach(t => t.classList.toggle('active', t.dataset.o === _instO));
  // The OS toggle only changes the one-liner; dim + disable it otherwise.
  const osEl = document.querySelector('.inst-os');
  if (osEl) {
    const matters = _instM === 'oneliner';
    osEl.style.opacity = matters ? '1' : '0.4';
    osEl.style.pointerEvents = matters ? 'auto' : 'none';
  }
}

function pickMethod(m) {
  _instM = m;
  renderInstall();
}

function pickOS(o) {
  _instO = o;
  renderInstall();
}

function copyInstall(btn) {
  const txt = document.getElementById('inst-cmd').textContent;
  navigator.clipboard.writeText(txt).then(() => {
    const orig = btn.innerHTML;
    btn.textContent = '✓';
    setTimeout(() => {
      btn.innerHTML = orig;
    }, 1200);
  }).catch(() => {});
}

renderInstall();
```

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

### Clone Repository and Install Dependencies

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/MACOS-SETUP.md

Clones the Clawd Cursor repository from GitHub, navigates into the project directory, installs npm dependencies, and builds the project.

```bash
git clone https://github.com/AmrDab/clawdcursor.git
cd clawdcursor && npm install && npm run build
```

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

### Install clawdcursor on macOS/Linux

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/internal/v0.9.3-release-body-draft.md

Use this command to perform a fresh installation of clawdcursor on macOS or Linux systems.

```bash
curl -fsSL https://clawdcursor.com/install.sh | bash
```

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

### Start Clawd Cursor Agent

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/MACOS-SETUP.md

Starts the Clawd Cursor agent using the default npm script. This is the primary command to run the application.

```bash
npm start
```

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

### Install AT-SPI for Linux Arch

Source: https://github.com/amrdab/clawdcursor/blob/main/SKILL.md

Install the necessary Python packages for AT-SPI accessibility support on Arch Linux.

```bash
sudo pacman -S python-gobject at-spi2-core
```

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

### Lint App Guide Locally

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/app-guides/index.html

Validate your app guide JSON file locally using the Clawdcursor CLI before submitting a Pull Request.

```bash
# validate locally before opening the PR
clawdcursor guides lint my-app.json
```

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

### HTTP MCP Request Example

Source: https://github.com/amrdab/clawdcursor/blob/main/SKILL.md

Example of a POST request to the /mcp endpoint for calling a tool. Ensure the Authorization header is correctly set.

```json
POST /mcp
Authorization: Bearer <token>
Content-Type: application/json
Accept: application/json, text/event-stream

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "open_app",
    "arguments": {"name": "Notepad"}
  }
}
```

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

### Example Tools for Structured (a11y) Tier

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/internal/v0.9-readme-building-blocks.md

These are example tools used when the UI exposes a full accessibility tree. No image tokens are required for this tier.

```text
accessibility(invoke), accessibility(find), accessibility(set_value)
```

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

### Install AT-SPI for Linux X11

Source: https://github.com/amrdab/clawdcursor/blob/main/SKILL.md

Install the necessary Python packages for AT-SPI accessibility support on Debian/Ubuntu-based Linux distributions.

```bash
sudo apt install python3-gi gir1.2-atspi-2.0
```

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

### Accessibility Tool Example

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/internal/v0.9-readme-building-blocks.md

Interact with structured UI elements using the accessibility tool. This example shows how to invoke an element named 'Send'.

```python
accessibility({"action":"invoke","name":"Send"})
```

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

### Guide Cache Module

Source: https://github.com/amrdab/clawdcursor/blob/main/CHANGELOG.md

Implements an LRU cache with a TTL of 7 days and a capacity of 50 entries. Usage is tracked to keep popular guides in cache.

```typescript
src/llm/knowledge/cache.ts — LRU + TTL (7 days, 50 entries). `touchUsage` reorders LRU on every hit, so popular guides survive eviction even when not most-recently-fetched.
```

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

### Index JSON Schema Example

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/guide-marketplace.md

This JSON structure represents the auto-generated index file for guides, including versioning, trust levels, and vote counts. It is used by the client for conditional GET requests.

```json
{
  "schemaVersion": 1,
  "generatedAt": "2026-05-13T12:34:56Z",
  "guides": {
    "youtube": {
      "version": "1.2.0",
      "trust": "verified",
      "upvotes": 42,
      "downvotes": 1,
      "submitter": "@user",
      "etag": "..."
    }
  }
}
```

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

### Cloudflare Worker for App Guides Routing

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/guide-marketplace.md

Example Cloudflare Worker code to proxy requests from /app-guides/* to the raw GitHub content of the Clawdcursor guides repository. This is the recommended approach for live operation.

```javascript
addEventListener('fetch', e => {
  const url = new URL(e.request.url);
  if (url.pathname.startsWith('/app-guides/')) {
    const file = url.pathname.replace('/app-guides/', '');
    return e.respondWith(fetch(`https://raw.githubusercontent.com/AmrDab/clawdcursor-guides/main/${file}`));
  }
  return e.respondWith(fetch(e.request));
});
```

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

### Get Clawd Cursor Version

Source: https://github.com/amrdab/clawdcursor/blob/main/SECURITY.md

Use this command to retrieve the currently installed version of Clawd Cursor. This information is helpful when reporting issues.

```bash
clawdcursor --version
```

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

### Example Tool Calls

Source: https://github.com/amrdab/clawdcursor/blob/main/README.md

Demonstrates calling various granular tools, such as key presses, element invocation, application opening, and screen OCR.

```javascript
key_press({ key: "mod+s" })
invoke_element({ name: "Send" })
open_app({ name: "Outlook" })
ocr_screen()
```

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

### Install Clawdcursor via npm

Source: https://github.com/amrdab/clawdcursor/blob/main/README.md

Installs the Clawdcursor package globally using npm. This is a cross-platform installation method.

```bash
npm i -g clawdcursor
```

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

### Install Clawdcursor with npm

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/index.html

The one-liner command to install Clawdcursor on macOS, Linux, or Windows. It installs Node.js if needed and sets up the global shim.

```bash
$ VERSION=v0.9.9
$ npm install -g @clawdcursor/cli
$ clawdcursor consent --accept
$ clawdcursor doctor
```

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

### Example of Compound Tool Usage

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/index.html

Demonstrates how to use a compound tool for keyboard input. This is the recommended compact form for most actions.

```javascript
computer({"action": "key", "combo": "mod+s"})
```

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

### Build Native Helper for macOS npm Install

Source: https://github.com/amrdab/clawdcursor/blob/main/CHANGELOG.md

If installing ClawdCursor globally via npm on macOS, you need to manually build the native helper application after installation.

```bash
cd $(npm root -g)/clawdcursor && bash native/build.sh && clawdcursor grant
```

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

### Mutate Guides

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/internal/v0.9-design.md

Mutates the app knowledge by updating guide files.

```APIDOC
## POST /learn

### Description
Mutate app knowledge by updating `guides/*.json`.

### Method
POST

### Endpoint
/learn

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
- **guideData** (object) - Required - The data for the guide to be updated.

### Request Example
```json
{
  "guideData": {
    "guideName": "New Guide",
    "content": "This is the content of the new guide."
  }
}
```

### Response
#### Success Response (200)
- **message** (string) - Confirmation that the guide has been updated.
```

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

### Guide Linter Module

Source: https://github.com/amrdab/clawdcursor/blob/main/CHANGELOG.md

Performs schema validation, detects prompt-injection patterns, and checks for dangerous prose in app guides. Failed guides are dropped to prevent agent poisoning.

```typescript
src/llm/knowledge/guide-linter.ts — defense-in-depth: schema validation + prompt-injection patterns + dangerous-prose detection runs on every guide before injection, regardless of source (bundled, cached, user-override). Failed guides drop to null — agent falls back to first-principles reasoning, never poisoned-knowledge.
```

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

### Load Context: System Prompt and App Detection

Source: https://github.com/amrdab/clawdcursor/blob/main/README.md

Initializes clawdcursor's operating stance and detects the active application. Call `system_prompt` once, then `detect_app` with a URL or title. If an `appKey` is returned, use `app_guide` to retrieve specific prompt fragments for your LLM.

```json
{"action":"system_prompt"}
```

```json
{"action":"detect_app","urlOrTitle":"..."}
```

```json
{"action":"classify_task","task":"...","activeWindowTitle":"..."}
```

```json
{"action":"app_guide","app":appKey}
```

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

### Open URL

Source: https://github.com/amrdab/clawdcursor/blob/main/SKILL.md

Use the window tool to open a specified URL.

```json
window({"action":"open_url","url":"https://..."})
```

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

### Install FlaUInspect with Chocolatey

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/ACCESSIBILITY-RESEARCH.md

FlaUInspect is an open-source UIA tree viewer. It can be installed using the Chocolatey package manager.

```bash
choco install flauinspect
```

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

### Open Notepad Application

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/internal/0.9.2-live-test-2026-05-16.md

Opens the Notepad application. This is the first step in driving a GUI interaction.

```javascript
window.open_app("notepad")
```

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

### Screenshot Helper Usage

Source: https://github.com/amrdab/clawdcursor/blob/main/native/README.md

Execute the screenshot-helper binary to capture a specific window or the entire screen. The output is saved to a specified file path.

```bash
./ClawdCursor.app/Contents/MacOS/screenshot-helper <windowId> /tmp/screenshot.png
```

```bash
./ClawdCursor.app/Contents/MacOS/screenshot-helper --fullscreen /tmp/fullscreen.png
```

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

### Commit Message Examples

Source: https://github.com/amrdab/clawdcursor/blob/main/CONTRIBUTING.md

Examples of conventional commit messages for various types of changes like fixes, features, documentation, and releases.

```shell
fix(safety): close-window confirm prompt now renders on Wayland
feat(compact): add browser({"action":"page_context"})
docs(readme): correct compact-action enum names
release(0.8.7): two-line summary
```

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

### Open File

Source: https://github.com/amrdab/clawdcursor/blob/main/SKILL.md

Use the window tool to open a specified file by its path.

```json
window({"action":"open_file","path":"/home/..."})
```

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

### Node UI Automation with @bright-fish/node-ui-automation

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/ACCESSIBILITY-RESEARCH.md

This JavaScript code snippet shows how to use the @bright-fish/node-ui-automation library to interact with Windows UI Automation. It demonstrates finding a window, locating a button, invoking it, and retrieving element properties.

```javascript
const { Automation, PropertyIds, TreeScopes, PatternIds } = require('@bright-fish/node-ui-automation');

const automation = new Automation();
const desktop = automation.getRootElement();

// Find a window by name
const windowCondition = automation.createPropertyCondition(
  PropertyIds.NamePropertyId,
  'About Windows'
);
const window = desktop.findFirst(TreeScopes.Subtree, windowCondition);

// Find and click a button
const okCondition = automation.createPropertyCondition(
  PropertyIds.NamePropertyId,
  'OK'
);
const okButton = window.findFirst(TreeScopes.Subtree, okCondition);
const invokePattern = okButton.getCurrentPattern(PatternIds.InvokePatternId);
invokePattern.invoke();

// Get element properties
const name = okButton.getCurrentPropertyValue(PropertyIds.NamePropertyId);
const rect = okButton.getCurrentPropertyValue(PropertyIds.BoundingRectanglePropertyId);
```

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

### Run Clawdcursor in Different Modes

Source: https://github.com/amrdab/clawdcursor/blob/main/docs/index.html

Commands to start and manage Clawdcursor services. Use 'mcp' for editor integration and 'agent' for a persistent daemon with optional LLM capabilities.

```bash
clawdcursor mcp
clawdcursor mcp --compact
clawdcursor agent
clawdcursor agent --no-llm
clawdcursor stop
clawdcursor uninstall
```