Skip to main content
Cursor is a first-class Observal harness integration. Observal can install Cursor agents, configure MCP servers, and collect Cursor session telemetry.

Overview

Cursor agent profiles are Markdown files. Project agents live in .cursor/agents/. User agents live in ~/.cursor/agents/. Cursor supports project and user installation scopes. MCP servers, hooks, and agent profiles are managed under the .cursor configuration directory.

Supported capabilities

Setup

1. Install the Observal CLI

2. Authenticate

This writes credentials to ~/.observal/config.json.

3. Pull an agent into Cursor

Cursor’s default scope is project scope. By default, the agent is written to .cursor/agents/{name}.md. To install into your user configuration:
User agents are written to ~/.cursor/agents/{name}.md.

Config paths

Cursor MCP configs use the mcpServers key.

Hook spec

Event map

Session delivery and parsing

Cursor keeps its built-in cursor parser. Its adapter resolves the transcript path supplied by Cursor, with project-directory discovery as a fallback, and discovers separately stored subagent transcripts. Cursor hook timeouts require a split delivery path: the hook synchronously writes complete transcript records and Stop-event token usage into the durable SQLite outbox, then a detached shared worker performs network delivery. The local byte/line cursor is not advanced by the hook or worker launch; it advances only after the server acknowledges a contiguous checkpoint. A delayed finalizer captures records written after Cursor’s Stop event, restores stale local state from the server checkpoint, and performs the final hash audit. Audit mismatches rewind and replay the affected range.

Caveats

Default scope is project. observal agent pull <agent-name> --harness cursor writes to .cursor/agents/ unless --scope user is specified. Configuration lives under .cursor. Agent profiles, MCP configuration, skills, and hooks are stored in the .cursor directory for project installs and under ~/.cursor for user installs. Auto model sentinel configuration is not available.