A command-line skill for searching locally indexed KakaoTalk messages and exporting selected conversation content or attachments. It supports keyword search, relevance-ranked search, and meaning-based vector search, which finds related text rather than only exact words.

Use it to search chats, list rooms, retrieve matching excerpts, export transcripts or attachments, and prepare information for a reply.

It lets an agent find and summarise conversations without directly opening KakaoTalk's database files, while keeping full message content behind explicit requests.

katok — Skill for Claude Code and Codex by changeroa/lazykatok

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent

npx skills add changeroa/lazykatok --skill katok

Clone the repo

git clone --depth 1 https://github.com/changeroa/lazykatok

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

README.md

[![agentmods](https://agentmods.dev/badge/skills/changeroa/lazykatok/katok/github.svg)](https://agentmods.dev/skills/changeroa/lazykatok/katok)

Your own site

<a href="https://agentmods.dev/skills/changeroa/lazykatok/katok"><img src="https://agentmods.dev/badge/skills/changeroa/lazykatok/katok/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

Your own site · 80×15

<a href="https://agentmods.dev/skills/changeroa/lazykatok/katok"><img src="https://agentmods.dev/badge/skills/changeroa/lazykatok/katok.svg" alt="Reviewed on agentmods" width="80" height="20"></a>

Per session 48 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.

When invoked 3,196 The whole file, excluding the scripts and references it only reads on demand.

Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.

Origin 100% copy Near-identical to another mod in the catalogue.

Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

Model	Per session	Once invoked
Fable 5.1	$0.00048	$0.03196
Opus 5.5	$0.00019	$0.01278
Sonnet 5.5	$0.00010	$0.00639
Haiku 4.5	$0.00005	$0.00320

Measured 17d ago against content hash 604b9cc4b42b, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

katok scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 17d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

100% identical to katok — 13 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

skills/katok/SKILL.md · 171 lines

How it starts

The opening of the file, as written. The whole thing — 171 lines — stays where its author put it; the contents beside it link to each section on GitHub.

katok

Use the katok CLI as the only execution surface. This skill stays thin: it checks readiness, calls CLI search commands, retrieves explicit chunks when needed, and summarizes results.

Privacy Rules

Do not inspect local database internals from the skill.
Do not handle auth caches or decryption material.
Do not read KakaoTalk DB files directly. Use katok sync --source macos --json.
Search commands return minimal snippets and chunk ids by default.
Full chunk content is shown only when the user explicitly asks for an exact result, asks to open a result, or provides a chunk id.

Commands

export PATH="$HOME/.cargo/bin:$PATH"       # use when katok is not found after cargo install
katok doctor --json
katok permissions macos                   # opens Full Disk Access settings
katok permissions macos --accessibility   # also opens Accessibility settings
katok doctor --macos-probe --json        # explicit macOS permission/app-data probe
katok sync --source macos --json          # reads live macOS KakaoTalk (needs Full Disk Access)
katok sync --json                         # uses source_adapter from config
katok index --json                        # builds local EmbeddingGemma vector index
katok index --full --json                 # full rebuild instead of incremental
katok wipe-index --yes                    # drops the local index
katok source chats --source macos --json  # lists rooms with their chat ids
katok search keyword "검색어" --json
katok search bm25 "검색어" --json
katok search semantic "지난 회의 보고서" --json
katok search hybrid "지난 회의 보고서" --json   # BM25 + semantic, fused over parent windows
katok chunk get <chunk-id> --json
katok chunk get <chunk-id> --redact --json
katok chunk context <chunk-id> --json
katok chunk parent <chunk-id> --json
katok chunks --chat <chat-id> --json      # every chunk in one room (metadata only)
katok transcript --chat <chat-id> --json                      # exports one room to Markdown
katok transcript --chat <chat-id> --since 2026-07-20 --json   # only messages at or after a time
katok transcript --chat <chat-id> --out <dir> --json          # writes outside the data dir
katok media get --chat <chat-id> --out <dir> --json   # photos, albums, videos, and files
katok media get --chat <chat-id> --kind file --json   # only file attachments (zip, pdf, xlsx, ...)
katok media get --chat <chat-id> --out <dir> --no-cdn --json   # local tiers only
katok media backfill --dry-run --json   # what is still fetchable across every room
katok media backfill --json             # save it before the presigned links expire
katok send --chat <chat-id> --dry-run --json

Read the full file on GitHub · 171 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

17d ago Changed · +3 lines 604b9cc4b42b
1mo ago First seen · 168 lines · 48 tokens per session scan A 875a0645265d

Subscribe to this mod's changes

katok is a skill published in the GitHub repository changeroa/lazykatok (45 stars, last pushed 18d ago), licensed MIT. It adds 48 tokens to every session and 3,196 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. It is 100% identical to katok, differing in 13 lines, and is treated as a copy.

Memory and context

katok next to 6 skills from other repositories
Mod	Type	Stars	Last push	Licence	Scan	Tokens	Works with
katokchangeroa/lazykatok	Skill	45	18d ago	MIT	A	48	Claude Code, Codex
knowledge-ingestopenclaw/openclaw	Skill	394k	yesterday	MIT	A	80	Claude Code, Codex
mem0-oss-to-platformmem0ai/mem0	Skill	68k	2d ago	Apache-2.0	A	217	Claude Code, Codex
forgetasgeirtj/system_prompts_leaks	Skill	71k	2d ago	CC0-1.0	A	74	Claude Code, Codex
Cortexdanielmiessler/LifeOS	Skill	20k	yesterday	MIT	A	184	Claude Code
memoryopensquilla/opensquilla	Skill	7.1k	6d ago	Apache-2.0	A	44	Claude Code, Codex
ha-data-storesshiwenwen/hope-agent	Skill	1.9k	yesterday	MIT	A	115	Claude Code, Codex

katok

Getting it into your agent

Wrote this? Show the measurements

What it costs to keep this loaded

Grade A, and why

Nothing flagged

This is a copy

How it starts

katok

Privacy Rules

Commands

What this file has done since we first saw it

katok compared with skills from other repositories