Chronicle

Name: Chronicle
Author: aniketxdey

โดย aniketxdeyรุ่น 0.3.0i★ –iรันบนเครื่อง

ชื่อใน registryio.github.aniketxdey/chronicle

ติดตั้ง

ภาพรวม

คำอธิบายจากผู้ทำ (ภาษาอังกฤษตามต้นฉบับ)

Local screen and activity knowledge graph, served as context to computer-use agents.

สามเสาของ PopNx MCP

สามเรื่องนี้ไม่รวมเป็นคะแนนเดียว เพราะความเห็น การวัด และความนิยม เป็นคนละเรื่องกัน

เสียงผู้ใช้iยังไม่มีรีวิวรีวิวเปิดพร้อมระบบบัญชีในขั้นถัดไป
ผลตรวจเบื้องต้นของเราiผ่าน 1 จาก 1 ข้อตรวจจากข้อมูลที่เปิดอยู่ ยังไม่ได้สแกนโค้ด
การใช้งานiยังไม่ได้วัด★ –

ใช้ทำอะไรได้

ตัวนี้ยังไม่ได้เรียบเรียงเป็นภาษาไทย ด้านล่างคือข้อเท็จจริงที่เราอ่านจาก registry

การเชื่อมต่อ: รันบนเครื่อง
ช่องทาง (transport): stdio
หมวด: ค้นข้อมูลและความจำของ AI

ติดตั้ง

เลือกโปรแกรม AI ที่คุณใช้ แล้วคัดลอกค่าตั้งไปวาง

ก่อนติดตั้ง

ผลตรวจเบื้องต้น: ผ่าน 1 จาก 1 ข้อ
รันในเครื่องคุณด้วยสิทธิ์ของผู้ใช้คุณ (ไฟล์ อินเทอร์เน็ต แอปต่าง ๆ)
ค่าที่คุณต้องใส่เอง: CHRONICLE_HOME, CHRONICLE_DISABLE_CAPTURE

ต้องเตรียมก่อน

PyPIติดตั้ง uv ของ Python (มีคำสั่ง uvx) ในเครื่อง

คุณใช้แอปไหน

ClaudeClaude CodeCursorVS CodeChatGPT

เลือกแอปด้านบน เราจำไว้ให้ ครั้งหน้าปุ่มจะขึ้นว่า “ติดตั้งลง …”

เปิด Claude Desktop → Settings → Developer → Edit Config แล้ววางค่านี้ในไฟล์ claude_desktop_config.json

{
  "mcpServers": {
    "chronicle": {
      "command": "uvx",
      "args": [
        "chronicle-context",
        "mcp"
      ],
      "env": {
        "CHRONICLE_HOME": "ใส่ค่าของคุณ",
        "CHRONICLE_DISABLE_CAPTURE": "ใส่ค่าของคุณ"
      }
    }
  }
}

พิมพ์คำสั่งนี้ใน Terminal

claude mcp add chronicle --env CHRONICLE_HOME='ใส่ค่าของคุณ' --env CHRONICLE_DISABLE_CAPTURE='ใส่ค่าของคุณ' -- uvx chronicle-context mcp

เติมค่าที่เว้นว่างไว้ก่อนรัน

เปิดใน Cursor

หรือคัดลอกค่าตั้งเอง

วางในไฟล์ .cursor/mcp.json ของโปรเจกต์ หรือ ~/.cursor/mcp.json

{
  "mcpServers": {
    "chronicle": {
      "command": "uvx",
      "args": [
        "chronicle-context",
        "mcp"
      ],
      "env": {
        "CHRONICLE_HOME": "ใส่ค่าของคุณ",
        "CHRONICLE_DISABLE_CAPTURE": "ใส่ค่าของคุณ"
      }
    }
  }
}

เบราว์เซอร์จะถามก่อนเปิดแอป จากนั้นแอปแสดงค่าตั้งให้ตรวจแล้วกดยืนยัน ช่อง key เว้นว่างไว้ให้คุณใส่เอง

เปิดใน VS Code

หรือคัดลอกค่าตั้งเอง

วางในไฟล์ .vscode/mcp.json ของโปรเจกต์

{
  "servers": {
    "chronicle": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "chronicle-context",
        "mcp"
      ],
      "env": {
        "CHRONICLE_HOME": "ใส่ค่าของคุณ",
        "CHRONICLE_DISABLE_CAPTURE": "ใส่ค่าของคุณ"
      }
    }
  }
}

ตัวนี้รันในเครื่องคุณ แต่ ChatGPT ต่อได้เฉพาะ server บนอินเทอร์เน็ต ลองเลือกแอปอื่น

ตัวเลือกเก็บในคุกกี้บนเครื่องนี้ ไม่ต้องมีบัญชี

ค่าที่ต้องใส่เอง

CHRONICLE_HOME env
Folder for the database and screenshots (default ~/.chronicle)
CHRONICLE_DISABLE_CAPTURE env
Set to 1 so this process serves context but never records

ค่าตั้งนี้สร้างจากข้อมูลใน registry ของผู้ทำ ถ้าไม่ตรงกับ README ให้เชื่อ README

ทำอะไรได้บ้าง

รันในเครื่องคุณ รายการเครื่องมือจะขึ้นในแอป AI หลังติดตั้ง

ผลตรวจเบื้องต้นi

เราตรวจจากข้อมูลที่ใครก็เปิดดูได้ ยังไม่ได้อ่านโค้ด ข้อที่ไม่เกี่ยวกับตัวนี้ไม่นับในตัวหาร · ตรวจเมื่อ 7 พ.ย. 2569

✓ ผ่าน
ตัวตนผู้ทำตรงกับ repo
ชื่อใน registry ยืนยันด้วยบัญชี GitHub aniketxdey ซึ่งเป็นเจ้าของ repo
… ยังไม่ตรวจ
ยังมีคนดูแล
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
… ยังไม่ตรวจ
มีสัญญาอนุญาต (license)
ยังไม่ได้อ่านข้อมูล repo จาก GitHub
– ไม่เกี่ยว
endpoint ตอบ
ตัวนี้รันบนเครื่องคุณ ไม่มี endpoint บนอินเทอร์เน็ต
– ไม่เกี่ยว
ล็อกอินแบบ OAuth
ตัวนี้รันบนเครื่อง ใช้ค่าที่ตั้งในเครื่องแทน
… ยังไม่ตรวจ
คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง
รันในเครื่องคุณ เราอ่านรายการเครื่องมือได้เฉพาะตัวที่มี endpoint บนอินเทอร์เน็ต

เทียบกับตัวอื่นในหมวด ค้นข้อมูลและความจำของ AIi

ดาวมากกว่า 0% ของอีก 7277 ตัวในหมวดนี้
ส่งรุ่นใหม่เข้า registry ล่าสุดกว่า 93% ของอีก 7277 ตัวในหมวดนี้
ผลตรวจเบื้องต้นดีกว่าหรือเท่ากับ 100% ของอีก 7277 ตัวในหมวดนี้

เทียบกับทุก server ที่ยังใช้งานในหมวดนี้ทั้งทะเบียน ดาวนับเฉพาะเมื่อผู้ลงทะเบียนเป็นเจ้าของ repo

คำถามที่พบบ่อย

Chronicle ปลอดภัยไหม?

จากการตรวจเบื้องต้นของเรา ผ่าน 1 จาก 1 ข้อที่ตรวจได้ เรายังไม่ได้อ่านโค้ด ก่อนใส่กุญแจหรือ token ให้ดูว่า server ขอสิทธิ์อะไร และเลือกกุญแจที่ทำได้เท่าที่จำเป็น

ต้องใช้กุญแจหรือรหัสอะไรบ้าง?

registry ไม่ได้ระบุว่าต้องใช้กุญแจ แต่บางตัวจะขอให้ล็อกอินตอนใช้ครั้งแรก

ตัวนี้รันบนเครื่องหรือบนคลาวด์?

รันบนเครื่องของคุณ โปรแกรม AI จะเปิด server ขึ้นมาเองเมื่อใช้ ข้อมูลไม่ต้องผ่านเซิร์ฟเวอร์ของผู้ทำ (ยกเว้นตัวที่ไปเรียกบริการออนไลน์ต่อ)

ยังมีคนดูแลอยู่ไหม?

repo บน GitHub มีการแก้โค้ดล่าสุด – และส่งรุ่นล่าสุด (0.3.0) เข้า registry 3 วันที่ผ่านมา

ใช้กับโปรแกรมไหนได้บ้าง?

โปรแกรมที่รองรับ MCP เช่น Claude Desktop, Claude Code, Cursor และ VS Code ตัวนี้ต้องมี Python (uv) ในเครื่องด้วย

มีตัวไหนใช้แทนได้บ้าง?

ในหมวดเดียวกันมี Context7, Codebase Memory, Exa

ตัวที่ใช้แทนได้

server หมวดเดียวกันจากผู้ทำคนอื่น เรียงตามดาว

อ่านการ์ด:★ ดาว GitHubiสามเสา: รีวิว · ผลตรวจ · การใช้งานiอัปเดต = วันที่ส่งรุ่นล่าสุดเข้า registryi

Context7

โดย upstash

ส่งคู่มือการใช้ไลบรารีและเฟรมเวิร์กรุ่นล่าสุดให้ AI อ่านก่อนตอบ ช่วยให้โค้ดที่ AI เขียนไม่ใช้คำสั่งเก่าที่เลิกใช้แล้ว

บนเครื่องหรือคลาวด์★ 64,224MITอัปเดต เมื่อวาน

ติดตั้ง

Codebase Memory

โดย DeusData

Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.

รันบนเครื่อง★ 48,148MITอัปเดต 21 วันที่ผ่านมา

ติดตั้ง

Exa

โดย exa-labs

Connect AI agents to Exa for web search, content fetching, and multi-step research.

รันบนคลาวด์★ 5,213MITอัปเดต เดือนที่แล้ว

ติดตั้ง

README จากผู้ทำ

เปิดอ่าน README

ส่วนนี้คัดจาก repo ของผู้ทำตามต้นฉบับ PopNx MCP ไม่ได้ตรวจหรือรับรองเนื้อหา ตัด HTML รูปภาพ และสคริปต์ออกแล้ว ลิงก์จะพาออกนอกเว็บ

Chronicle

Record your screen and system events on your computer, write context files and workflows from them, and build them into LLM harnesses for any task. Any AI can use a harness over MCP or as downloaded files.

The full documentation covers the app, every command, and the API.

An agent usually starts each task with no knowledge of your computer. It doesn't know your ticket, your open file, or your last search, so you paste that context by hand. Chronicle keeps that memory on your computer and lets the agent request it:

Continue your work. "Finish the Acme export" works because the agent can see export.ts, the status of PR 882, and the Notion spec.
Teach by showing. Record a task once. The agent gets the apps, pages, and steps in order.
Use tools without MCP. Download a harness as a .zip or one Markdown file for ChatGPT, Claude Projects, NotebookLM, Neo4j, or a RAG pipeline.

Chronicle stores everything in ~/.chronicle, with no account and no telemetry. See Privacy for what leaves your computer.

Quick start

Chronicle needs Python 3.10 or newer. macOS is the main platform, and Linux (X11) and Windows support is best effort.

These commands load a synthetic workday, so Chronicle records nothing.

uv tool install --python 3.12 "chronicle-context[graph]"

chronicle demo chronicle context "finish the Acme export"

chronicle context prints the Markdown that the get_context MCP tool returns. The sample output starts like this:

# Computer context (Chronicle)

Task: finish the Acme export Window: the most recent 2h of history.

What you were doing

14:55-15:31 meeting Acme weekly · Jordan Hale (36m)
15:34-16:24 writing customer emails · export spec (50m)
16:28-16:48 coding export.ts · asking Priya (20m)

On screen now

Chrome · Checks · PR 882 (frame 18)
URL: https://github.com/northwind/billing/actions

To open the app, connect an agent, and record your own work:

chronicle serve

chronicle mcp install cursor chronicle doctor chronicle record 30m --label "file an expense report"

The app runs at http://127.0.0.1:3030. chronicle mcp clients lists every client.

Permissions and tools

Platform	What Chronicle needs
macOS	Screen Recording and Accessibility for the app that runs Chronicle. Local sources also need Full Disk Access
Linux	X11, a window manager, `xdotool`, and `xprop`. Wayland sessions aren't supported for window tracking
Linux screenshots	One of `grim`, `gnome-screenshot`, `scrot`, or ImageMagick `import`
Linux clipboard and idle time	`xclip` or `wl-paste`, and `xprintidle`
Windows	Nothing extra. Chronicle uses user32 and PowerShell
OCR, optional	`brew install tesseract` or `apt install tesseract-ocr`

On macOS, the app that runs Chronicle is your terminal or the MCP host, such as Claude Desktop or Cursor. Add it under System Settings › Privacy & Security, then quit and reopen it. Closing its windows isn't enough.

How it works

Record. A session runs for a set time, such as 90s, 30m, or 2h, or until you stop it. Every 5 seconds by default, Chronicle samples the front app, its window, and the browser URL. When something changes, and at least every 30 seconds, Chronicle also takes a screenshot and reads screen text. Chronicle never records keystrokes, and it skips password managers, System Settings, and private browser windows.

Read sources. Under Privacy & Sources, you can also turn on Apple Mail, Calendar, iMessage, WhatsApp, browser history, folders, and AI tool logs. Every source starts off.

Build the graph. Each session gets its own graph. Nodes include apps, pages, files, tickets, PRs, people, topics, and tasks. Every node and edge records its time and its source frames, so an agent can cite its evidence. The all-history graph combines the sessions, and older sessions count less.

Write. With a model set up, Chronicle names the graph's work, then writes context files and workflows when a recording ends. Without a model, Chronicle runs offline and builds plain context files from the evidence.

Serve. Agents read everything over MCP.

Level	What it is	Example
Harness	Everything an agent needs for a whole line of work	Recruiting
Context file	General guidance for one kind of session	Researching job companies
Workflow	A short procedure for one specific job	Customizing resume bullets

Connect an agent

Local clients

chronicle mcp install adds Chronicle to a client's config and keeps a .chronicle-backup copy of the old file. chronicle mcp config prints the snippet and writes nothing.

Client	Command
Claude Desktop	`chronicle mcp install claude-desktop`
Claude Code	`chronicle mcp install claude-code`
Cursor	`chronicle mcp install cursor`
VS Code (Copilot agent mode)	`chronicle mcp install vscode`
Windsurf	`chronicle mcp install windsurf`
OpenAI Codex CLI	`chronicle mcp install codex`
Gemini CLI	`chronicle mcp install gemini-cli`
Cline	`chronicle mcp install cline`
LM Studio	`chronicle mcp install lm-studio`
Zed	`chronicle mcp config zed`
Continue	`chronicle mcp config continue`
Goose	`chronicle mcp config goose`

Restart the client after an install. Only one Chronicle process captures at a time, so an agent can call start_recording without chronicle serve. chronicle mcp --no-record turns that off.

Packaged installs

Packaged installs need only uv.

claude plugin marketplace add aniketxdey/chronicle

claude plugin install chronicle@chronicle

gemini extensions install https://github.com/aniketxdey/chronicle

MCP Registry clients can search for io.github.aniketxdey/chronicle.

Hosted agents and APIs

Hosted agents need a public HTTPS URL. Anyone with the URL that these commands print can read your Chronicle data. Stop the tunnel when you finish.

export CHRONICLE_TOKEN=$(openssl rand -hex 16)

export CHRONICLE_PUBLIC_URL=https://YOUR-TUNNEL-HOST chronicle serve & cloudflared tunnel --url http://127.0.0.1:3030 echo "$CHRONICLE_PUBLIC_URL/mcp/$CHRONICLE_TOKEN"

chronicle mcp config prints a starting point for chatgpt, openai-api, anthropic-api, gemini-api, and http. Provider model names and beta flags change often, so check each provider's MCP documentation. The examples folder has longer scripts.

Files

The harness editor exports a .zip or one Markdown file. Each context file and workflow has Download .md. Each graph downloads as JSON, text, GraphML, or Cypher.

MCP tools

Tool	What it does
`list_harnesses`, `get_harness`, `read_harness_file`, `search_harness_graph`	Read a harness, its files, and its graph engine
`get_context_file`, `get_workflow`, `get_graph`	Read one context file, workflow, or graph
`get_context`	A context pack for a task, with an optional preset
`search_history`	Full-text search over screen text, events, transcripts, and memories
`query_graph`, `get_entity`, `graph_summary`	Find nodes, read their evidence, and get graph totals
`list_tasks`, `activity_summary`, `list_meetings`	Timelines and summaries
`get_frame`	One frame, optionally with its screenshot
`start_recording`, `stop_recording`, `list_sessions`	Record a demonstration, and list recordings
`rebuild_graph`, `tune_graph`	Rebuild a graph, or refine it with your model
`graph_review`, `graph_apply`	The connected agent curates the graph, with no Chronicle model
`search`, `fetch`	The interface that ChatGPT connectors and deep research expect

The server also has resources, such as chronicle://context/current, and two prompts: use_my_computer_context(task) and learn_from_recording(session_id). The MCP reference lists them all.

App, API, and CLI

chronicle serve runs the app at http://127.0.0.1:3030:

Page	What it does
Knowledge	Shows the graph of all your history, a chat, and your recordings. The chat can propose something to build, and builds nothing until you press its button
Harnesses	Builds a harness in five steps, then edits it by hand or by chat
Contexts	Holds general guidance for one kind of session
Workflows	Holds short procedures for one job
Integrations	Connects MCP clients and exports files
Privacy & Sources	Controls what Chronicle reads besides recordings
Settings	Controls capture, retention, and models

The REST API has interactive documentation at http://127.0.0.1:3030/docs. The CLI reference and REST reference list every command and route. The CLI has no harness commands.

Configuration

Variable	Default	Meaning
`CHRONICLE_HOME`	`~/.chronicle`	Database, screenshots, and lock file
`CHRONICLE_HOST`, `CHRONICLE_PORT`	`127.0.0.1`, `3030`	Where `chronicle serve` listens
`CHRONICLE_TOKEN`	Unset	Require this token on the HTTP API and MCP
`CHRONICLE_PUBLIC_URL`	`http://127.0.0.1:3030`	Base URL for links and remote client snippets
`CHRONICLE_DEMO=1`	Off	Load the sample workday into an empty database on start
`CHRONICLE_DISABLE_CAPTURE=1`	Off	Never record from this process
`CHRONICLE_HALF_LIFE_HOURS`	`72`	How fast older recordings count less in All history. `0` or `off` disables it
`CHRONICLE_LLM`	Unset	`openai`, `anthropic`, `gemini`, `openrouter`, `local`, or `off`
`CHRONICLE_LLM_MODEL`	Provider default	Model for the provider named by `CHRONICLE_LLM`
`CHRONICLE_LLM_BASE_URL`	`http://localhost:11434/v1`	Endpoint for the local provider

Chronicle reads these variables when a process starts. Settings in the app holds capture interval, idle threshold, screenshots, OCR, clipboard, redaction, and retention.

Models

A model is optional. Open Settings › Model, add a key, and press Use.

Provider	Default model	Key from the environment
OpenAI	`gpt-4.1-mini`	`OPENAI_API_KEY`
Anthropic	`claude-sonnet-5-5`	`ANTHROPIC_API_KEY`
Google Gemini	`gemini-2.5-flash`	`GEMINI_API_KEY`
OpenRouter	`openai/gpt-4.1-mini`	`OPENROUTER_API_KEY`
Local (Ollama, LM Studio)	You choose	Not needed

A key can also be in a .env file in ~/.chronicle or the current directory. A .env file never overrides a variable that is already set. Your choice in Settings overrides CHRONICLE_LLM, except CHRONICLE_LLM=off, which turns models off whatever Settings says.

Workflows, harness chat, and context file names use tool calls, so choose a model that supports them. Small local models often fail at these tasks.

Privacy

Recordings, screenshots, source items, and graphs stay in ~/.chronicle. Data leaves your computer in these cases:

MCP clients: a connected agent receives the tool results it requests.
Models: a cloud model receives window titles, URLs, system events, redacted screen text, and matching source items.
Tunnels: anyone with your URL and token can read your data.
Cloud sources: a provider sees the requests that Chronicle makes to it.

Redaction applies to text only. Screenshots keep whatever was on screen. [PRIVACY.md](https://github.com/aniketxdey/chronicle/blob/main/PRIVACY

ตัดมาแค่ช่วงต้น อ่านต่อใน repo

Chronicle

ภาพรวม

สามเสาของ PopNx MCP

ใช้ทำอะไรได้

ติดตั้ง

ก่อนติดตั้ง

ค่าที่ต้องใส่เอง

ทำอะไรได้บ้าง

ผลตรวจเบื้องต้นi

ตัวตนผู้ทำตรงกับ repo

ยังมีคนดูแล

มีสัญญาอนุญาต (license)

endpoint ตอบ

ล็อกอินแบบ OAuth

คำอธิบายเครื่องมือไม่มีคำสั่งแอบแฝง

เทียบกับตัวอื่นในหมวด ค้นข้อมูลและความจำของ AIi

คำถามที่พบบ่อย

ตัวที่ใช้แทนได้

Context7

Codebase Memory

Exa

README จากผู้ทำ

Chronicle

Quick start

What you were doing

On screen now

Permissions and tools

How it works

Connect an agent

Local clients

Packaged installs

Hosted agents and APIs

Files

MCP tools

App, API, and CLI

Configuration

Models

Privacy