openchronicle-setup

Install and configure OpenChronicle macOS agent memory with MCP client wiring.

1|Updated Apr 27, 2026
One-click install
npx skills add https://github.com/darkmatter/skills --skill openchronicle-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openchronicle-setup
Source: https://github.com/darkmatter/skills/tree/main/skills/openchronicle-setup
Command: npx skills add https://github.com/darkmatter/skills --skill openchronicle-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps users install, configure, connect, and troubleshoot OpenChronicle, a local-first macOS agent memory daemon, so their AI tools can capture context and use it reliably.

Core Features & Use Cases

  • Installation and setup: Guides users through upstream-aware installation, permission checks, and daemon startup on macOS.
  • Model and config tuning: Helps edit and verify OpenChronicle model stages, local or cloud provider settings, and runtime configuration files.
  • MCP client integration: Connects OpenChronicle to Codex, opencode, Claude Code, Claude Desktop, Cursor, and ChatGPT Desktop.
  • Troubleshooting and recovery: Diagnoses capture failures, daemon issues, port conflicts, stale state, index drift, and client connectivity problems.
  • Privacy-aware guidance: Highlights local data sensitivity and explains the risks of exposing memory services beyond localhost.

Quick Start

Ask for help installing OpenChronicle on your Mac, configuring its models, connecting it to your chosen agent client, and troubleshooting any capture or MCP issues.

Frequently Asked Questions about openchronicle-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I install and configure OpenChronicle local agent memory on macOS?

Installing OpenChronicle on macOS requires running the setup, verifying necessary macOS permissions, and starting the daemon. Configuration involves editing local runtime files and tuning model stages for reliable agent memory capture.

How do I connect OpenChronicle MCP server to Claude Code or Cursor?

Connecting OpenChronicle to clients like Claude Code or Cursor requires MCP client wiring. This involves configuring the MCP connection and validating capture so your AI tools can reliably access local memory context.

Does OpenChronicle agent memory work with Codex and ChatGPT Desktop?

OpenChronicle supports MCP client integration for Codex and ChatGPT Desktop. You can connect these agents to the local macOS memory daemon to capture and utilize context across your workflow.

Why is my OpenChronicle daemon not capturing context or failing to start?

OpenChronicle daemon capture failures or startup issues are often caused by port conflicts, stale state, or index drift. Troubleshooting involves diagnosing these elements alongside client connectivity and local macOS permissions.

What are the privacy limitations of running a local-first macOS memory daemon?

Running a local-first macOS memory daemon stores sensitive context locally, but exposing memory services beyond localhost introduces privacy risks. Safe handling requires restricting network exposure and protecting local configuration data.