find-my-session

Name: find-my-session
Author: SomeNoneAI

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

ชื่อใน registryio.github.SomeNoneAI/find-my-session

ติดตั้ง

ภาพรวม

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

Read-only session finder across coding-agent harnesses: search, page prompts, hand off.

สามเสาของ PopNx MCP

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

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

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

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

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

ติดตั้ง

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

ก่อนติดตั้ง

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

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

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

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

ClaudeClaude CodeCursorVS CodeChatGPT

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

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

{
  "mcpServers": {
    "find-my-session": {
      "command": "uvx",
      "args": [
        "find-my-session"
      ]
    }
  }
}

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

claude mcp add find-my-session -- uvx find-my-session

เปิดใน Cursor

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

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

{
  "mcpServers": {
    "find-my-session": {
      "command": "uvx",
      "args": [
        "find-my-session"
      ]
    }
  }
}

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

เปิดใน VS Code

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

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

{
  "servers": {
    "find-my-session": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "find-my-session"
      ]
    }
  }
}

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

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

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

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

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

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

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

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

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

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

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

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

find-my-session ปลอดภัยไหม?

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

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

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

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

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

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

repo บน GitHub มีการแก้โค้ดล่าสุด – และส่งรุ่นล่าสุด (0.1.4) เข้า registry เมื่อวานซืน

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

โปรแกรมที่รองรับ 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อัปเดต 2 เดือนที่ผ่านมา

ติดตั้ง

README จากผู้ทำ

เปิดอ่าน README

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

find-my-session

🌐 中文说明

A local, read-only session finder and handoff tool for coding agents, shipped in two forms that share one fms_lib core:

find-my-session-skill — an agent skill (fms CLI) that finds the right session across harnesses and prints a low-token handoff digest instead of the whole transcript.
find-my-session-ui — a human-friendly browser panel for the same stores.

When a harness runs out of quota, you usually remember *what* you were doing but not *where* the session lives. fms answers that with one compact command.

Screenshots use synthetic fixture data.

Ask your agent

If the skill is installed, just talk to your agent in plain language — no fms flags needed:

/find-my-session 找到 claude-code 最近的一个会话，继续那个任务
/find-my-session find the most recent claude-code session and continue that task
/find-my-session 额度用完了，在 claude-code 里找昨天关于鉴权的那次会话并接力
/find-my-session search my claude-code sessions about token refresh and show the handoff digest
/find-my-session 列出这个项目最近一次 claude-code 会话里我提过的所有需求

The agent resolves the harness, runs search / latest / show / prompts, and continues the work.

Supported harnesses

Twenty-two adapters are ready; one more is planned. Verified versions, surfaces, and caveats live in the compatibility matrix; per-harness store details live in references/.

Harness	Ref prefix	Store
Qoder CN	`qoder-cn`	`~/.qoder-cn`
Qoder (international)	`qoder`	`~/.qoder`
Kimi Code	`kimi-code`	`~/.kimi-code`
ZCode	`zcode`	`~/.zcode`
CodeArts Agent	`codearts-agent`	`~/.codeartsdoer`
ChatGPT Codex	`codex`	`~/.codex`
DeepSeek Harness	`deepseek`	`~/.dsh`
Claude Code	`claude-code`	`~/.claude`
Cline	`cline`	`~/.cline`
Grok Build	`grok-build`	`~/.grok`
WorkBuddy AI	`workbuddy`	`~/.workbuddy-ai`
WorkBuddy (domestic)	`workbuddy-cn`	`~/.workbuddy`
Antigravity	`antigravity`	`~/.gemini/antigravity`
Antigravity CLI	`antigravity-cli`	`~/.gemini/antigravity-cli`
MiniMax Code	`minimax-code`	`~/.minimax/v2`
Cursor	`cursor`	`~/.cursor/projects`
OpenCode	`opencode`	`~/.local/share/opencode`
Gemini CLI	`gemini-cli`	`~/.gemini`
Qwen Code	`qwen`	`~/.qwen`
Pi	`pi`	`~/.pi/agent/sessions`
Oh My Pi	`omp`	`~/.omp/agent/sessions`
CodeBuddy CN	`codebuddy-cn`	`CodeBuddy CN/codebuddy-sessions.vscdb`
Cline (VS Code extension)	`cline-vscode` (planned)	VS Code globalStorage

Requirements

Python 3.9 or newer; macOS or Linux. Python 3.9 is end-of-life upstream and 0.2 is planned to require 3.10+ (see ROADMAP.md).
No third-party Python packages
Compressed stores (codex .jsonl.zst, deepseek .zstd) need a zstd decoder: Python 3.14+ or the zstd CLI; otherwise those sessions are skipped
Windows is exercised by an experimental, non-blocking CI job but is not supported yet; see ROADMAP.md

Install

CLI and UI commands

pipx install find-my-session installs the fms and fms-ui commands from PyPI. To run an unreleased commit, install from Git instead: pipx install git+https://github.com/SomeNoneAI/find-my-session.git. Use pipx upgrade find-my-session to upgrade or pipx uninstall find-my-session to remove them. With uv, uvx --from find-my-session fms ... runs the PyPI release without a permanent install.

For agents: the skill

Release ZIP. Each GitHub Release publishes find-my-session-skill.zip. Download it from the latest release, then install it into your harness (for example, unzip it into ~/.claude/skills for Claude Code, or link the directory into your harness's skills folder).
Source checkout.

   git clone https://github.com/SomeNoneAI/find-my-session.git

cd find-my-session ln -s "$PWD/skills/find-my-session" ~/.claude/skills/find-my-session # Claude Code; adapt the path for your harness

From a checkout you can also run the CLI directly as python3 skills/find-my-session/scripts/fms, or run python3 tools/build_artifacts.py to build dist/find-my-session-skill.zip yourself. To remove a linked skill, delete its symlink from the harness's skills folder.

For humans: the UI panel

Release ZIP. Download find-my-session-ui.zip from the latest release, extract it, and run python3 fms-ui from the extracted directory (or ./fms-ui when your extractor preserves executable bits). Replace that directory to upgrade or delete it to uninstall.
pipx. The same pipx install above provides the fms-ui command.
Source checkout. Run fms_ui/fms-ui (use --no-browser --port 8765 to pick a port without opening a browser).

The panel starts a read-only server on 127.0.0.1 with keyword and metadata filters, session overviews, paged user prompts, recent turns, and copyable refs. The static frontend uses only same-origin JSON APIs — no Node.js, no external assets. Language follows the local system, with an explicit zh/en switch. The interface also follows the system light/dark preference, with a manual toggle and a non-black dark palette. The frontend is built with Vue 3 + TypeScript + Vite; Node.js is needed only when developing it from fms_ui/frontend/, never to run the panel.

Quick start

fms harnesses                                     # list ready and planned harnesses

fms search "quota handoff" --harness claude-code # find sessions by keywords fms latest --harness claude-code --cwd . # most recent session in this repo fms show claude-code:c1a0de01 # low-token handoff digest fms prompts claude-code:c1a0de01 --count # count human prompts, then page with --limit/--offset fms resume claude-code:e1a2b3c4 --exec # jump straight back into a session fms stats --since 7d # token/cost totals across harnesses

Search prefers an explicit --harness; omit the query to list recent sessions. Archived sessions are excluded from search/latest unless --include-archived is passed. show stays read-only and prints the raw source path so an agent can grep the original file when the digest is not enough.

Commands

Command	Purpose
`fms harnesses`	List ready and planned harnesses, variants, and stores.
`fms search [query ...]`	Search session metadata by keywords; omit the query to list recent sessions.
`fms latest`	Return the most recent matching session.
`fms show`	Print a handoff digest for one session.
`fms prompts`	List every human prompt in one session; count, page, and order them.
`fms mcp`	Run the Model Context Protocol server on stdio: exposes search/show/prompts/stats/doctor as read-only MCP tools for MCP-native hosts. See docs/mcp.md.
`fms stats [--harness] [--since] [--json]`	Aggregate the token/cost usage that harnesses themselves record; harnesses without recorded usage show `-`.
`fms resume [--exec]`	Print (or run) the harness command that reopens the session; falls back to the handoff digest when no resume command is verified.
`fms doctor [--harness] [--json] [--fingerprint]`	Check the local environment and stores (decoder availability, readable roots, per-harness health); `--fingerprint` adds a content-free shape summary for drift reports.

Useful options

Option	Applies to	Meaning
`--harness NAME[,NAME]`	search, latest, show, prompts, doctor	Restrict lookup to a harness. Recommended for speed and precision.
`--cwd PATH`	search, latest	Match a session whose working directory contains, or is contained by, `PATH`.
`--since 7d` / `--since 2026-10-01`	search, latest	Filter by last update time.
`--limit N`	search, latest, prompts	Limit results or prompts; `0` means unlimited.
`--offset N`	prompts	Skip the first N prompts.
`--order oldest/newest`	prompts	Page order; original indices are preserved.
`--count`	prompts	Print only the total prompt count.
`--deep`	search, latest	Also scan full transcripts. Slower; still prints metadata only.
`--include-archived`	search, latest	Include archived sessions. Off by default.
`--verbose`	search, latest	Warn about skipped sessions on stderr without changing stdout.
`--messages N` / `--chars N` / `--summary-chars N`	show	Cap turns, per-message characters, and summary characters.
`--json`	harnesses, search, latest, prompts, doctor	Machine-readable output; use `--format json` for `show`. See docs/json-output.md for the field contract.

Session references use harness:session-prefix (for example claude-code:c1a0de01); a raw transcript path from a supported store works too.

Picking with fzf

Every listing is plain TSV, so interactive picking is a pipe away:

fms search --limit 0 | fzf | cut -f1 | xargs -I{} fms show {}

fms search --limit 0 --include-archived | fzf --with-nth=2,4 | cut -f1 | xargs -I{} fms resume {}

The second recipe resumes the picked session in its own harness when the harness has a verified resume command (see fms resume --help). Desktop/CLI surfaces that share one store share one ref space — see the compatibility matrix for which surfaces are verified.

Privacy and safety

Everything runs locally; the CLI makes no network requests.
The CLI only reads session files and databases, opening SQLite stores read-only; it never edits or deletes session content.
Search output is metadata-only; show and prompts can print conversation content, so treat their output like the original transcript.

Development and documentation

CONTRIBUTING.md — setup, tests, and how to add or verify a harness.
docs/compatibility.md — the detailed, per-harness compatibility matrix.
docs/json-output.md — the --json field contract and pre-1.0 stability policy.
docs/faq.md — 5-minute tutorial and answers to the most common "where is my session" questions.
ROADMAP.md — near-term plans.
SECURITY.md — supported versions and private vulnerability reporting.
skills/find-my-session/references/ — per-harness store schemas and verification recipes; start with extending.md to add a harness.

python3 -m unittest discover -s tests -v

python3 -m compileall -q core fms_ui skills/find-my-session/scripts tools tests python3 tools/build_artifacts.py # rebuild dist/find-my-session-skill(.zip) and dist/find-my-session-ui(.zip)

License

MIT. See LICENSE.

<!-- mcp-name: io.

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

find-my-session

ภาพรวม

สามเสาของ PopNx MCP

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

ติดตั้ง

ก่อนติดตั้ง

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

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

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

ยังมีคนดูแล

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

endpoint ตอบ

ล็อกอินแบบ OAuth

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

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

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

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

Context7

Codebase Memory

Exa

README จากผู้ทำ

find-my-session

Ask your agent

Supported harnesses

Requirements

Install

CLI and UI commands

For agents: the skill

For humans: the UI panel

Quick start

Commands

Useful options

Picking with fzf

Privacy and safety

Development and documentation

License