이 문서는 설치부터 메시지 읽기·전송, MCP 서버, 문제 해결까지 자주 쓰는 흐름을 한국어로 정리합니다. 모든 옵션과 최신 계약은 영문 전체 레퍼런스에서 확인할 수 있습니다.
kmsg
복사brew install channprj/tap/kmsg\n
brew install channprj/tap/kmsg\n
업데이트는 다음 명령으로 진행합니다.
복사kmsg update\n
kmsg update\n
kmsg update는 필요하면 Homebrew를 설치하고, 포뮬러를 설치하거나 업그레이드한 뒤, 직접 설치한 바이너리를 Homebrew 명령으로 연결합니다.
kmsg update
릴리스에는 Apple Silicon과 Intel Mac을 모두 지원하는 kmsg-macos-universal 바이너리가 포함됩니다.
kmsg-macos-universal
복사mkdir -p ~/.local/bin\ncurl -fL \\\n https://github.com/channprj/kmsg/releases/latest/download/kmsg-macos-universal \\\n -o ~/.local/bin/kmsg\nchmod +x ~/.local/bin/kmsg\nkmsg --version\n
mkdir -p ~/.local/bin\ncurl -fL \\\n https://github.com/channprj/kmsg/releases/latest/download/kmsg-macos-universal \\\n -o ~/.local/bin/kmsg\nchmod +x ~/.local/bin/kmsg\nkmsg --version\n
직접 받은 바이너리도 kmsg update를 실행하면 Homebrew 설치본으로 전환됩니다.
복사git clone https://github.com/channprj/kmsg.git\ncd kmsg\nswift build -c release\ninstall -m 755 .build/release/kmsg ~/.local/bin/kmsg\n
git clone https://github.com/channprj/kmsg.git\ncd kmsg\nswift build -c release\ninstall -m 755 .build/release/kmsg ~/.local/bin/kmsg\n
먼저 권한과 KakaoTalk 상태를 확인합니다.
복사kmsg status --verbose\n
kmsg status --verbose\n
채팅 목록을 확인하고 최근 메시지를 읽습니다.
복사kmsg chats --limit 20\nkmsg read \"채팅방 이름\" --limit 20\n
kmsg chats --limit 20\nkmsg read \"채팅방 이름\" --limit 20\n
실제 전송 전에는 반드시 dry run으로 대상과 메시지를 확인할 수 있습니다.
복사kmsg send \"채팅방 이름\" \"안녕하세요\" --dry-run\n
kmsg send \"채팅방 이름\" \"안녕하세요\" --dry-run\n
--dry-run은 KakaoTalk UI에 접근하기 전에 종료하므로 실제 메시지를 전송하지 않습니다.
--dry-run
대화형 명령은 KakaoTalk 로그인 상태를 확인합니다. 새 자격 증명을 입력하거나 저장된 자격 증명을 재사용할 수 있습니다.
복사kmsg auth login\nkmsg auth login --auto\n
kmsg auth login\nkmsg auth login --auto\n
비밀번호는 AES-GCM으로 암호화하며 자격 증명과 키를 소유자 전용 권한으로 분리 저장합니다. 이 파일은 공유하거나 이슈에 첨부하지 마세요.
복사~/.config/kmsg/credentials.json\n~/.config/kmsg/credentials/primary.key\n
~/.config/kmsg/credentials.json\n~/.config/kmsg/credentials/primary.key\n
KakaoTalk 잠금 화면이 떠 있으면 명령을 실행하기 전에 잠금을 해제하고, 원래 요청을 그대로 이어서 수행합니다.
비밀번호는 이미 저장된 값에서 가져옵니다. 이전 해제에서 기억해 둔 잠금 비밀번호를 먼저 쓰고, 없으면 kmsg auth login으로 저장한 계정 비밀번호를 씁니다. 둘 다 없을 때만 입력을 요청하며, 성공한 값은 기억해 둡니다.
kmsg auth login
잠금 해제는 명령마다 한 번만 시도합니다. 비밀번호를 여러 번 틀리면 KakaoTalk이 계정을 로그아웃시키기 때문입니다. 저장된 계정 비밀번호가 거부되면 다시 시도하지 않으므로, kmsg auth login으로 현재 비밀번호를 저장하세요.
터미널이 없는 호출자(kmsg mcp-server, kmsg watch, cron)는 입력을 받을 수 없으므로 저장된 자격 증명에 의존합니다.
kmsg mcp-server
kmsg watch
kmsg status
kmsg chats
chat_id
kmsg read
kmsg send
kmsg send-image
kmsg inspect
kmsg cache
포그라운드 작업을 방해하면 안 되는 자동화에서는 --background-safe를 사용합니다.
--background-safe
복사kmsg read \"채팅방 이름\" --json --background-safe\n
kmsg read \"채팅방 이름\" --json --background-safe\n
이 모드는 KakaoTalk을 실행하거나 활성화하지 않고, 로그인·검색·창 열기·크기 조절·닫기도 수행하지 않습니다. 일치하는 채팅 창이 이미 열려 있지 않으면 실패합니다.
이 CLI 플래그는 kmsg v1.260618.0부터 제공되며 kmsg read 명령에서만 사용할 수 있습니다. 현재 셸이 실행하는 바이너리를 먼저 확인하세요.
v1.260618.0
복사kmsg --version\nkmsg read --help\n
kmsg --version\nkmsg read --help\n
도움말에 플래그가 없다면 Homebrew 설치본을 업데이트한 뒤 다시 확인합니다.
복사brew update\nbrew upgrade kmsg\nkmsg read --help\n
brew update\nbrew upgrade kmsg\nkmsg read --help\n
MCP 클라이언트에서는 CLI 표기인 --background-safe 대신 JSON 인자 background_safe: true를 사용합니다.
background_safe: true
복사kmsg send <recipient> <message> [options]\nkmsg send --chat-id <chat-id> <message> [options]\n
kmsg send <recipient> <message> [options]\nkmsg send --chat-id <chat-id> <message> [options]\n
주요 옵션은 다음과 같습니다.
--chat-id ID
--keep-window
--no-cache
--layout MODE
preserve
left
right
split-left
split-right
복사kmsg send-image \"채팅방 이름\" /absolute/path/image.png --dry-run\n
kmsg send-image \"채팅방 이름\" /absolute/path/image.png --dry-run\n
이미지 경로는 읽을 수 있는 로컬 파일이어야 합니다. dry run으로 확인한 뒤에만 실제 전송을 실행하세요.
--json을 지원하는 명령은 구조화된 결과를 stdout에 기록하고 AX 추적 로그는 stderr에 분리합니다.
--json
stdout
stderr
복사kmsg chats --json\nkmsg read \"채팅방 이름\" --json --limit 20\nkmsg watch \"채팅방 이름\" --json\n
kmsg chats --json\nkmsg read \"채팅방 이름\" --json --limit 20\nkmsg watch \"채팅방 이름\" --json\n
네이티브 MCP 서버는 다음 도구를 제공합니다.
kmsg_read
kmsg_send
kmsg_send_image
전송 도구에서 confirm=false 또는 생략된 confirm은 즉시 전송합니다. confirm=true는 전송하지 않고 CONFIRMATION_REQUIRED를 반환합니다.
confirm=false
confirm
confirm=true
CONFIRMATION_REQUIRED
KMSG_MCP_KMSG_PATH
KMSG_MCP_TIMEOUT_SECONDS
30
KMSG_DEFAULT_LAYOUT
KMSG_DEFAULT_BACKGROUND_SAFE
false
KMSG_DEFAULT_DEEP_RECOVERY
KMSG_MCP_STARTUP_STATUS_CHECK
복사kmsg status\n
kmsg status\n
시스템 설정에서 실제로 실행하는 바이너리를 허용한 뒤 다시 시도합니다. Homebrew 경로와 직접 빌드 경로는 서로 다른 바이너리로 인식될 수 있습니다.
복사kmsg chats --verbose --limit 50\nkmsg cache clear\nkmsg read \"정확한 채팅방 이름\" --deep-recovery\n
kmsg chats --verbose --limit 50\nkmsg cache clear\nkmsg read \"정확한 채팅방 이름\" --deep-recovery\n
반복 자동화에서는 kmsg chats로 레지스트리를 갱신하고 chat_id를 사용하는 편이 안정적입니다.
복사kmsg read \"채팅방 이름\" --debug --trace-ax\nkmsg inspect --depth 5\nkmsg cache stats\n
kmsg read \"채팅방 이름\" --debug --trace-ax\nkmsg inspect --depth 5\nkmsg cache stats\n
KakaoTalk 업데이트 후에는 캐시를 지우고 다시 탐색하세요.
복사swift build\nswift build -c release\npython3 -m pytest -q\n
swift build\nswift build -c release\npython3 -m pytest -q\n
릴리스 버전은 루트의 VERSION을 기준으로 하며 수동 편집 대신 프로젝트의 릴리스 명령을 사용합니다. 자세한 규칙은 버전 관리 문서를 참고하세요.
VERSION
This guide covers installation, first-run setup, every public CLI command,\nconfiguration, output formats, MCP operation, troubleshooting, and release\nmaintenance.
Copybrew install channprj/tap/kmsg\n
The tap publishes kmsg for the latest release and retains exact-version\nformulae for the ten most recent published releases.
Update an existing installation with:
Copykmsg update\n
kmsg update installs Homebrew when it is missing, installs or upgrades the\nformula, and links a directly installed binary to the Homebrew-managed command.\nThe plain Homebrew equivalent is brew update followed by brew upgrade kmsg.
brew update
brew upgrade kmsg
The release workflow publishes a universal macOS binary named\nkmsg-macos-universal.
Copymkdir -p ~/.local/bin\ncurl -fL \\\n https://github.com/channprj/kmsg/releases/latest/download/kmsg-macos-universal \\\n -o ~/.local/bin/kmsg\nchmod +x ~/.local/bin/kmsg\n
mkdir -p ~/.local/bin\ncurl -fL \\\n https://github.com/channprj/kmsg/releases/latest/download/kmsg-macos-universal \\\n -o ~/.local/bin/kmsg\nchmod +x ~/.local/bin/kmsg\n
Ensure ~/.local/bin is in PATH, then verify the binary:
~/.local/bin
PATH
Copykmsg --version\n
kmsg --version\n
Run kmsg update later to move this binary onto the Homebrew-managed release.
Source builds require Swift 6.
Copygit clone https://github.com/channprj/kmsg.git\ncd kmsg\nswift build -c release\ninstall -m 755 .build/release/kmsg ~/.local/bin/kmsg\n
Run the environment check first:
Copykmsg status\n
macOS may open the Accessibility settings pane. Enable the binary you actually\nrun, then retry kmsg status.
List chats and read recent messages:
Copykmsg chats\nkmsg read \"Chat name\" --limit 20\n
kmsg chats\nkmsg read \"Chat name\" --limit 20\n
Preview a send without changing KakaoTalk:
Copykmsg send \"Chat name\" \"Hello\" --dry-run\n
kmsg send \"Chat name\" \"Hello\" --dry-run\n
After verifying the target and message, omit --dry-run to send.
Commands that require interactive KakaoTalk access automatically check the\nlogin state. If saved credentials are unavailable, kmsg prompts in the\nterminal and stores them locally.
Enter fresh credentials explicitly:
Copykmsg auth login\n
kmsg auth login\n
Reuse stored credentials when available:
Copykmsg auth login --auto\n
kmsg auth login --auto\n
Add --trace-ax to print Accessibility traversal and retry diagnostics.
--trace-ax
The password is encrypted with AES-GCM. The credential document and encryption\nkey are stored separately with owner-only filesystem permissions:
Copy~/.config/kmsg/credentials.json\n~/.config/kmsg/credentials/primary.key\n
When KakaoTalk's lock screen is showing, commands unlock it before continuing,\nthen carry on with the original request.
The passcode comes from what is already stored: the passcode remembered from an\nearlier unlock, otherwise the account password saved by kmsg auth login. kmsg\nprompts only when neither is available, and remembers whatever worked.
Only one unlock attempt is made per command, because KakaoTalk signs the account\nout after repeated wrong passcodes. A saved account password the lock screen\nrefuses is not tried again — run kmsg auth login to save the current one.
Callers without a terminal — kmsg mcp-server, kmsg watch, cron jobs — cannot\nprompt, so they depend on those stored credentials.
Copykmsg\nkmsg --help\nkmsg --version\nkmsg -v\n
kmsg\nkmsg --help\nkmsg --version\nkmsg -v\n
Running kmsg without a subcommand runs status.
status
Copykmsg status [--verbose]\n
kmsg status [--verbose]\n
Checks Accessibility permission, launches KakaoTalk if needed, verifies\nauthentication, and prints readiness information.
--verbose
auth login
Copykmsg auth login [--auto] [--trace-ax]\n
kmsg auth login [--auto] [--trace-ax]\n
--auto
Without --auto, the command prompts for fresh credentials and replaces the\nstored values.
chats
Copykmsg chats [options]\n
kmsg chats [options]\n
-v
-l N
--limit N
N
20
-k
Each result includes a local synthetic chat_id. The registry is refreshed by\nrunning kmsg chats and stored at ~/.kmsg/chat-registry.json.
~/.kmsg/chat-registry.json
read
Copykmsg read <chat> [options]\nkmsg read --chat-id <chat-id> [options]\n
kmsg read <chat> [options]\nkmsg read --chat-id <chat-id> [options]\n
A chat name and --chat-id are mutually exclusive.
--chat-id
--debug
--deep-recovery
The name form supports partial matching. For repeated automation, use a\nchat_id after refreshing the registry with kmsg chats.
--background-safe is suitable for automation that must not disturb foreground\nwork, but it fails unless the matching chat window is already exposed.
The CLI flag is available in kmsg v1.260618.0 and later, and belongs only to\nthe kmsg read command. Check the binary that your shell actually resolves:
Copykmsg --version\nkmsg read --help\n
If the help output does not list the flag, update the Homebrew installation and\ncheck again:
Copybrew update\nbrew upgrade kmsg\nkmsg read --help\n
MCP clients use the JSON argument background_safe: true instead of the CLI\nspelling --background-safe.
Messages whose author cannot be resolved are represented as \"(me)\".
\"(me)\"
watch
Copykmsg watch <chat> [options]\n
kmsg watch <chat> [options]\n
--poll-interval S
0.2
0.2...10.0
--include-system
At startup, watch stabilizes a transcript baseline for up to two seconds and\ndoes not replay the existing history. Rows that cannot be assigned a safe\ntimestamp may be suppressed during startup.
Stop the process with Ctrl-C or SIGTERM.
SIGTERM
send
Copykmsg send <recipient> <message> [options]\nkmsg send --chat-id <chat-id> <message> [options]\n
--refresh-cache
Without --keep-window, windows opened transiently by the command are closed\nafter the send attempt.
send-image
Copykmsg send-image <recipient> <image-path> [options]\n
kmsg send-image <recipient> <image-path> [options]\n
The path must point to a readable image. kmsg loads the image into the macOS\npasteboard and completes KakaoTalk's image-send UI.
inspect
Copykmsg inspect [options]\n
kmsg inspect [options]\n
-d N
--depth N
4
-w N
--window N
--show-attributes
--show-path
--show-frame
--show-index
--show-flags
--show-actions
--debug-layout
--row-summary
--row-range A:B
--row-range applies only with --row-summary.
--row-range
cache
Copykmsg cache\nkmsg cache status\nkmsg cache clear\nkmsg cache export <output-path>\nkmsg cache import <input-path>\nkmsg cache warmup [options]\n
kmsg cache\nkmsg cache status\nkmsg cache clear\nkmsg cache export <output-path>\nkmsg cache import <input-path>\nkmsg cache warmup [options]\n
Running kmsg cache without a subcommand runs cache status.
cache status
clear
export PATH
import PATH
warmup
cache warmup accepts:
cache warmup
--recipient NAME
mcp-server
Copykmsg mcp-server\n
kmsg mcp-server\n
Starts the native stdio MCP server. It accepts both Content-Length framing and\none JSON-RPC request per line, and responds using the request's transport style.
Content-Length
The server exposes:
chat
For send tools, confirm=false or an omitted confirm sends immediately.\nconfirm=true does not send; it returns CONFIRMATION_REQUIRED so a supervisor\ncan request approval and call again.
See docs/openclaw.md for complete integration examples.
update
Moves the current installation onto the Homebrew-managed release:
brew
/opt/homebrew/bin/brew
/usr/local/bin/brew
brew install
brew upgrade
channprj/tap/kmsg
--version
.build
Progress goes to stderr and the final summary to stdout. Homebrew or sudo\nmay ask for confirmation. The command needs no Accessibility permission and\nnever edits shell startup files.
sudo
Copykmsg chats --json\n
kmsg chats --json\n
Copy{\n \"count\": 1,\n \"chats\": [\n {\n \"title\": \"홍길동\",\n \"chat_id\": \"chat_7f42c5e1d9ab\",\n \"last_message\": \"곧 도착해요\"\n }\n ]\n}\n
{\n \"count\": 1,\n \"chats\": [\n {\n \"title\": \"홍길동\",\n \"chat_id\": \"chat_7f42c5e1d9ab\",\n \"last_message\": \"곧 도착해요\"\n }\n ]\n}\n
Copykmsg read \"홍길동\" --limit 20 --json\n
kmsg read \"홍길동\" --limit 20 --json\n
Copy{\n \"chat\": \"홍길동\",\n \"fetched_at\": \"2026-02-26T01:23:45.678Z\",\n \"count\": 1,\n \"messages\": [\n {\n \"author\": \"홍길동\",\n \"time_raw\": \"00:27\",\n \"date\": \"2026-02-26\",\n \"body\": \"밤이 깊었네\",\n \"has_image\": false,\n \"image_count\": 0,\n \"link_count\": 0,\n \"has_attachment\": false,\n \"attachment_count\": 0\n }\n ]\n}\n
{\n \"chat\": \"홍길동\",\n \"fetched_at\": \"2026-02-26T01:23:45.678Z\",\n \"count\": 1,\n \"messages\": [\n {\n \"author\": \"홍길동\",\n \"time_raw\": \"00:27\",\n \"date\": \"2026-02-26\",\n \"body\": \"밤이 깊었네\",\n \"has_image\": false,\n \"image_count\": 0,\n \"link_count\": 0,\n \"has_attachment\": false,\n \"attachment_count\": 0\n }\n ]\n}\n
date and time_raw may be absent when KakaoTalk does not expose the\ncorresponding metadata.
date
time_raw
Copykmsg watch \"홍길동\" --json\n
kmsg watch \"홍길동\" --json\n
Copy{\n \"chat\": \"홍길동\",\n \"detected_at\": \"2026-03-25T10:20:30.123Z\",\n \"event\": \"message\",\n \"message\": {\n \"author\": \"홍길동\",\n \"time_raw\": \"10:20\",\n \"body\": \"새 메시지\",\n \"has_image\": false,\n \"image_count\": 0,\n \"link_count\": 0,\n \"has_attachment\": false,\n \"attachment_count\": 0\n }\n}\n
{\n \"chat\": \"홍길동\",\n \"detected_at\": \"2026-03-25T10:20:30.123Z\",\n \"event\": \"message\",\n \"message\": {\n \"author\": \"홍길동\",\n \"time_raw\": \"10:20\",\n \"body\": \"새 메시지\",\n \"has_image\": false,\n \"image_count\": 0,\n \"link_count\": 0,\n \"has_attachment\": false,\n \"attachment_count\": 0\n }\n}\n
With --include-system, event may be \"system\".
event
\"system\"
JSON payloads are written to stdout. --trace-ax diagnostics remain on\nstderr.
KMSG_AX_TIMEOUT
0.25
0.05...5.0
deep_recovery
background_safe
KMSG_TRACE_DEFAULT
trace_ax
KMSG_DEFAULT_READ_LAYOUT
true
KMSG_MCP_VERSION
Example:
CopyKMSG_DEFAULT_BACKGROUND_SAFE=true \\\nKMSG_DEFAULT_READ_LAYOUT=split-right \\\nkmsg mcp-server\n
KMSG_DEFAULT_BACKGROUND_SAFE=true \\\nKMSG_DEFAULT_READ_LAYOUT=split-right \\\nkmsg mcp-server\n
~/.config/kmsg/credentials.json
~/.config/kmsg/credentials/primary.key
~/.kmsg/ax-cache.json
Do not publish these files or include their contents in issue reports.
Read without disturbing foreground windows:
Copykmsg read \"홍길동\" --json --background-safe\n
kmsg read \"홍길동\" --json --background-safe\n
Read by synthetic ID and arrange the window on the right:
Copykmsg chats --json\nkmsg read --chat-id \"chat_7f42c5e1d9ab\" \\\n --layout split-right \\\n --limit 50 \\\n --json\n
kmsg chats --json\nkmsg read --chat-id \"chat_7f42c5e1d9ab\" \\\n --layout split-right \\\n --limit 50 \\\n --json\n
Watch for new messages:
Copykmsg watch \"홍길동\" --json --poll-interval 0.5\n
kmsg watch \"홍길동\" --json --poll-interval 0.5\n
Preview and then send:
Copykmsg send \"홍길동\" \"안녕하세요\" --dry-run\nkmsg send \"홍길동\" \"안녕하세요\"\n
kmsg send \"홍길동\" \"안녕하세요\" --dry-run\nkmsg send \"홍길동\" \"안녕하세요\"\n
Warm and inspect the AX cache:
Copykmsg cache warmup --recipient \"홍길동\" --trace-ax\nkmsg cache status\n
kmsg cache warmup --recipient \"홍길동\" --trace-ax\nkmsg cache status\n
Collect parsing diagnostics:
Copykmsg inspect --window 0 --depth 20 --debug-layout\nkmsg inspect --window 0 --depth 20 --row-summary --row-range 10:30\nkmsg read \"홍길동\" --limit 20 --trace-ax\n
kmsg inspect --window 0 --depth 20 --debug-layout\nkmsg inspect --window 0 --depth 20 --row-summary --row-range 10:30\nkmsg read \"홍길동\" --limit 20 --trace-ax\n
A rebuilt or moved binary may need to be added again.
Open KakaoTalk manually, complete login if necessary, and run:
Copykmsg status --verbose\n
Use --deep-recovery only when the normal fast path cannot recover a window.
Refresh local identities:
A renamed room receives a new local identity. If duplicate rooms have the same\nname, prefer the chat_id values produced from the current chat list.
--background-safe never opens or searches for a chat. Expose the target chat\nwindow first, or omit the flag when foreground automation is acceptable.
Collect both hierarchy and trace evidence:
Copykmsg inspect --window 0 --depth 20 --row-summary\nkmsg read \"Chat name\" --trace-ax\n
kmsg inspect --window 0 --depth 20 --row-summary\nkmsg read \"Chat name\" --trace-ax\n
Attach the relevant output to an issue after removing private message content.
Copykmsg cache status\nkmsg cache clear\n
kmsg cache status\nkmsg cache clear\n
Verify target and message parsing without touching KakaoTalk:
Copykmsg send \"Chat name\" \"Test\" --dry-run\n
kmsg send \"Chat name\" \"Test\" --dry-run\n
--dry-run exits before KakaoTalk access. If a real test send is acceptable,\nretry that send with --no-cache to compare the uncached UI path:
Copykmsg send \"Chat name\" \"Test\" --no-cache\n
kmsg send \"Chat name\" \"Test\" --no-cache\n
Verify the binary directly:
Copykmsg --version\nkmsg status\nkmsg mcp-server\n
kmsg --version\nkmsg status\nkmsg mcp-server\n
The MCP server skips the interactive status check by default. Set\nKMSG_MCP_STARTUP_STATUS_CHECK=true only when startup should validate full\nKakaoTalk readiness.
KMSG_MCP_STARTUP_STATUS_CHECK=true
Build debug and release variants:
Copyswift build\nswift build -c release\n.build/debug/kmsg --version\n
swift build\nswift build -c release\n.build/debug/kmsg --version\n
Useful manual checks:
Copy.build/debug/kmsg status --verbose\n.build/debug/kmsg inspect --depth 5\n.build/debug/kmsg chats --verbose --limit 20\n.build/debug/kmsg send \"Name\" \"Message\" --dry-run\n.build/debug/kmsg read \"Chat\" --limit 50\n
.build/debug/kmsg status --verbose\n.build/debug/kmsg inspect --depth 5\n.build/debug/kmsg chats --verbose --limit 20\n.build/debug/kmsg send \"Name\" \"Message\" --dry-run\n.build/debug/kmsg read \"Chat\" --limit 50\n
The root VERSION file is managed through Headatever-backed make targets:
Copymake version\nmake release\nmake release-major\nmake release-push\n
make version\nmake release\nmake release-major\nmake release-push\n
Do not hand-edit VERSION. See VERSIONING.md for the\nMAJOR.YYMMDD.PATCH_COUNT rules.
MAJOR.YYMMDD.PATCH_COUNT
Pushing a matching v* tag triggers the release workflow, which:
v*
このページでは、インストールからメッセージの読み取り・送信、MCPサーバー、トラブルシューティングまでの主要な操作を説明します。全オプションは英語版リファレンスで確認できます。
コピーbrew install channprj/tap/kmsg\n
アップデート:
コピーkmsg update\n
kmsg updateは必要に応じてHomebrewをインストールし、フォーミュラをインストールまたはアップグレードし、直接インストールしたバイナリをHomebrew管理のコマンドにリンクします。
コピーgit clone https://github.com/channprj/kmsg.git\ncd kmsg\nswift build -c release\ninstall -m 755 .build/release/kmsg ~/.local/bin/kmsg\n
最初に権限とKakaoTalkの状態を確認します。
コピーkmsg status --verbose\n
チャット一覧を取得し、最近のメッセージを読みます。
コピーkmsg chats --limit 20\nkmsg read \"チャット名\" --limit 20\n
kmsg chats --limit 20\nkmsg read \"チャット名\" --limit 20\n
送信前に対象と内容を確認します。
コピーkmsg send \"チャット名\" \"こんにちは\" --dry-run\n
kmsg send \"チャット名\" \"こんにちは\" --dry-run\n
--dry-runはKakaoTalk UIへアクセスする前に終了するため、メッセージを送信しません。
コピーkmsg auth login\nkmsg auth login --auto\n
パスワードはAES-GCMで暗号化され、認証情報と鍵は所有者だけが読める別々のファイルに保存されます。これらのファイルを公開しないでください。
コピー~/.config/kmsg/credentials.json\n~/.config/kmsg/credentials/primary.key\n
KakaoTalkのロック画面が表示されている場合は、コマンドの実行前にロックを解除し、元の要求をそのまま続行します。
パスワードは保存済みの値から取得します。前回の解除で記憶したロックパスワードを優先し、無ければkmsg auth loginで保存したアカウントのパスワードを使います。どちらも無い場合のみ入力を求め、成功した値を記憶します。
ロック解除はコマンドごとに一度だけ試行します。パスワードを何度も間違えるとKakaoTalkがアカウントをログアウトさせるためです。保存済みのアカウントパスワードが拒否された場合は再試行しないので、kmsg auth loginで現在のパスワードを保存してください。
ターミナルを持たない呼び出し元（kmsg mcp-server、kmsg watch、cron）は入力を受け取れないため、保存済みの認証情報に依存します。
前面での作業を妨げたくない場合は--background-safeを使います。
コピーkmsg read \"チャット名\" --json --background-safe\n
kmsg read \"チャット名\" --json --background-safe\n
このモードはKakaoTalkの起動・アクティブ化・ログイン・検索・ウィンドウ操作を行いません。対象のチャットウィンドウがすでに表示されていなければ失敗します。
このCLIフラグはkmsg v1.260618.0以降で提供され、kmsg readコマンドでのみ使用できます。現在のシェルが実行するバイナリを確認してください。
コピーkmsg --version\nkmsg read --help\n
ヘルプにフラグが表示されない場合は、Homebrew版を更新して再確認します。
コピーbrew update\nbrew upgrade kmsg\nkmsg read --help\n
MCPクライアントでは、CLI表記の--background-safeではなくJSON引数background_safe: trueを使用します。
コピーkmsg send <recipient> <message> [options]\nkmsg send --chat-id <chat-id> <message> [options]\n
画像送信:
コピーkmsg send-image \"チャット名\" /absolute/path/image.png --dry-run\n
kmsg send-image \"チャット名\" /absolute/path/image.png --dry-run\n
コピーkmsg chats --json\nkmsg read \"チャット名\" --json\nkmsg watch \"チャット名\" --json\n
kmsg chats --json\nkmsg read \"チャット名\" --json\nkmsg watch \"チャット名\" --json\n
構造化結果はstdout、AX診断はstderrに出力されます。
MCPサーバーは次のツールを公開します。
送信ツールでは、confirm=trueは送信せずCONFIRMATION_REQUIREDを返します。confirm=falseまたは省略時は即時送信です。
コピーkmsg status\n
システム設定で、実際に実行しているバイナリを許可します。Homebrew版とローカルビルドは別のバイナリとして扱われる場合があります。
コピーkmsg chats --verbose --limit 50\nkmsg cache clear\nkmsg read \"正確なチャット名\" --deep-recovery\n
kmsg chats --verbose --limit 50\nkmsg cache clear\nkmsg read \"正確なチャット名\" --deep-recovery\n
繰り返し実行する自動化では、kmsg chatsでレジストリを更新しchat_idを利用すると安定します。
コピーkmsg read \"チャット名\" --debug --trace-ax\nkmsg inspect --depth 5\nkmsg cache stats\n
kmsg read \"チャット名\" --debug --trace-ax\nkmsg inspect --depth 5\nkmsg cache stats\n
KakaoTalk更新後はキャッシュを消去して再探索してください。
本页介绍安装、消息读取与发送、MCP服务器以及常见故障处理。全部参数与最新契约请参阅英文完整参考。
复制brew install channprj/tap/kmsg\n
更新:
复制kmsg update\n
kmsg update会在需要时安装Homebrew，安装或升级formula，并将直接安装的二进制文件链接到由Homebrew管理的命令。
复制git clone https://github.com/channprj/kmsg.git\ncd kmsg\nswift build -c release\ninstall -m 755 .build/release/kmsg ~/.local/bin/kmsg\n
首先检查权限和KakaoTalk状态。
复制kmsg status --verbose\n
列出聊天并读取最近消息。
复制kmsg chats --limit 20\nkmsg read \"聊天名称\" --limit 20\n
kmsg chats --limit 20\nkmsg read \"聊天名称\" --limit 20\n
发送前先检查目标与内容。
复制kmsg send \"聊天名称\" \"你好\" --dry-run\n
kmsg send \"聊天名称\" \"你好\" --dry-run\n
--dry-run会在访问KakaoTalk UI之前结束，因此不会发送消息。
复制kmsg auth login\nkmsg auth login --auto\n
密码使用AES-GCM加密，凭据和密钥分别存放在仅所有者可访问的文件中。请勿公开或上传这些文件。
复制~/.config/kmsg/credentials.json\n~/.config/kmsg/credentials/primary.key\n
如果KakaoTalk显示锁定界面，命令会先解锁再继续，并接着完成原本的请求。
密码取自已保存的值：优先使用上次解锁时记住的锁定密码，否则使用kmsg auth login保存的账号密码。只有两者都不可用时才会提示输入，并记住成功的值。
每条命令只尝试解锁一次，因为多次输错密码会导致KakaoTalk将账号登出。若已保存的账号密码被拒绝，则不会再次尝试，请运行kmsg auth login保存当前密码。
没有终端的调用方（kmsg mcp-server、kmsg watch、cron）无法接收输入，因此依赖这些已保存的凭据。
不希望打断前台工作时，可使用--background-safe。
复制kmsg read \"聊天名称\" --json --background-safe\n
kmsg read \"聊天名称\" --json --background-safe\n
此模式不会启动或激活KakaoTalk，也不会登录、搜索、打开、调整或关闭窗口。如果匹配的聊天窗口尚未显示，读取会失败。
此CLI标志从kmsg v1.260618.0开始提供，并且仅适用于kmsg read命令。请先确认当前Shell实际执行的二进制文件：
复制kmsg --version\nkmsg read --help\n
如果帮助中没有此标志，请更新Homebrew安装后再次检查：
复制brew update\nbrew upgrade kmsg\nkmsg read --help\n
MCP客户端不使用CLI写法--background-safe，而是使用JSON参数background_safe: true。
复制kmsg send <recipient> <message> [options]\nkmsg send --chat-id <chat-id> <message> [options]\n
发送图片:
复制kmsg send-image \"聊天名称\" /absolute/path/image.png --dry-run\n
kmsg send-image \"聊天名称\" /absolute/path/image.png --dry-run\n
复制kmsg chats --json\nkmsg read \"聊天名称\" --json\nkmsg watch \"聊天名称\" --json\n
kmsg chats --json\nkmsg read \"聊天名称\" --json\nkmsg watch \"聊天名称\" --json\n
结构化结果写入stdout，AX诊断写入stderr。
MCP服务器提供以下工具。
对于发送工具，confirm=true不会发送，而是返回CONFIRMATION_REQUIRED。confirm=false或省略时会立即发送。
复制kmsg status\n
请在系统设置中允许实际运行的二进制。Homebrew版本和本地构建可能会被视为不同的程序。
复制kmsg chats --verbose --limit 50\nkmsg cache clear\nkmsg read \"准确的聊天名称\" --deep-recovery\n
kmsg chats --verbose --limit 50\nkmsg cache clear\nkmsg read \"准确的聊天名称\" --deep-recovery\n
重复自动化时，建议先用kmsg chats刷新注册表，再使用chat_id。
复制kmsg read \"聊天名称\" --debug --trace-ax\nkmsg inspect --depth 5\nkmsg cache stats\n
kmsg read \"聊天名称\" --debug --trace-ax\nkmsg inspect --depth 5\nkmsg cache stats\n
KakaoTalk更新后，可清除缓存并重新发现路径。
kmsg는 macOS용 KakaoTalk을 터미널과 AI agent에서 다루기 위한 비공식 오픈소스 CLI이자 native MCP server입니다. 메시지 읽기, 새 메시지 감시, 텍스트·이미지 전송을 macOS Accessibility API로 수행하며 KakaoTalk의 비공개 LOCO protocol을 구현하거나 우회하지 않습니다.
kmsg는 자신의 Mac에서 반복 작업을 자동화하려는 개발자, 구조화 JSON으로 KakaoTalk 작업을 연결하려는 로컬 도구 제작자, 사용자 승인을 거쳐 메시지를 읽고 보내야 하는 AI agent를 위해 만들어졌습니다. 서버형 SaaS나 대량 메시지 발송 서비스가 아니라 사용자가 직접 소유하고 제어하는 Mac에서 실행되는 local-first 도구입니다.
프로젝트는 CHANN의 박희찬이 공개 GitHub 저장소 channprj/kmsg에서 유지합니다. source, issue history, release tag, MIT License, GitHub Actions 결과를 누구나 확인할 수 있습니다. 공식 웹사이트의 canonical URL은 https://channprj.github.io/kmsg/이며 release와 설치 정보는 같은 저장소를 기준으로 합니다.
channprj/kmsg
https://channprj.github.io/kmsg/
kmsg는 KakaoTalk의 화면과 접근성 계층을 사용하므로 실제 실행에는 macOS용 KakaoTalk, 로그인 상태, 해당 binary에 대한 Accessibility 권한이 필요합니다. 계정 정보와 메시지는 사용자의 Mac에서 처리되며 이 정적 웹사이트로 업로드되지 않습니다. 메시지 전송은 외부 상태를 바꾸므로 대상과 payload를 --dry-run으로 먼저 확인하는 방식을 권장합니다. background-safe 읽기, bounded search, local credential encryption, 명시적인 MCP tool contract를 통해 자동화가 수행하는 범위를 드러냅니다.
kmsg는 Kakao Corp.와 제휴하거나 승인받은 공식 제품이 아닙니다. KakaoTalk UI 변경으로 자동화가 영향을 받을 수 있으며 사용자는 대상, 권한, 전송 결과와 관련 정책을 직접 확인해야 합니다. 지원되는 platform, command, MCP transport와 알려진 제한은 이 사이트의 usage, architecture, developer, privacy 문서에 공개합니다. 확인할 수 없는 기업 규모나 보증을 주장하지 않고, 공개 source와 재현 가능한 test를 신뢰 근거로 제공합니다.
kmsg에 관한 버그 신고, 기능 제안, 설치·MCP 연동 질문은 공개 GitHub 저장소를 기본 창구로 사용합니다. 공개 issue를 사용하면 같은 문제를 겪는 사용자가 검색할 수 있고, source revision과 해결 과정이 기록으로 남습니다. 프로젝트는 유료 고객센터나 전화 지원을 운영하지 않으며 응답 시간 보장을 제공하지 않습니다.
GitHub Issues에서 새 issue를 작성하세요. 사용한 kmsg version, macOS version, KakaoTalk version, 실행한 command, 기대한 결과, 실제 오류 메시지와 최소 재현 절차를 포함하면 진단에 도움이 됩니다. Accessibility hierarchy나 chat output을 첨부하기 전에는 사람 이름, 채팅 내용, 전화번호, 계정 ID, local path와 credential을 반드시 제거하세요. 반복 가능한 예시는 실제 개인 메시지 대신 synthetic data를 사용하세요.
새 command, JSON field, MCP tool 또는 문서 개선 제안도 GitHub issue에서 논의합니다. 제안에는 해결하려는 실제 작업, 사용자에게 발생하는 side effect, 승인 경계, 실패 시 기대 동작을 적어 주세요. source 수준 질문은 developer resources와 architecture 문서를 먼저 확인하고, 기존 issue와 release note에 같은 주제가 없는지 검색하는 편이 좋습니다.
공개하면 안 되는 취약점이나 민감한 개인정보 문제는 공개 issue에 원문을 게시하지 말고 iam@chann.dev로 최소 정보만 보내세요. 제목에 kmsg security 또는 kmsg privacy를 포함하고 영향을 받는 version과 재현 조건을 설명하되, 실제 KakaoTalk password, message history, access token, encryption key는 보내지 마세요. 일반 지원 내용을 이 email로 보낸 경우 공개 issue로 이동해 달라는 안내를 받을 수 있습니다.
iam@chann.dev
kmsg security
kmsg privacy
공식 source는 https://github.com/channprj/kmsg, 공식 site는 https://channprj.github.io/kmsg/, maintainer profile은 https://github.com/channprj입니다. release binary는 GitHub Releases와 channprj/tap Homebrew tap에서 확인하세요. 이 경로와 다른 곳에서 받은 binary나 지원 요청은 프로젝트가 검증할 수 없습니다. 연락처나 policy가 바뀌면 이 페이지와 repository history에 함께 기록합니다.
https://github.com/channprj/kmsg
https://github.com/channprj
channprj/tap
이 페이지는 kmsg를 script, local automation, coding agent 또는 MCP client에 연결할 때 필요한 first-party 문서를 예측 가능한 한곳에 모읍니다. kmsg의 public interface는 macOS에서 실행되는 CLI, structured JSON output, newline event stream, native stdio MCP server입니다.
사용법 문서는 command, option, environment variable, output format과 troubleshooting을 다룹니다. kmsg chats, kmsg read, kmsg watch는 structured JSON을 제공하고 진단용 AX trace는 stderr로 분리합니다. kmsg는 hosted HTTP API나 REST OpenAPI specification을 제공하지 않습니다. 따라서 API key를 발급하거나 network endpoint에 request를 보내는 방식이 아니라 설치한 binary를 local process로 호출해야 합니다.
kmsg authentication은 KakaoTalk desktop login과 macOS Accessibility permission을 확인하는 local flow입니다. kmsg auth login은 필요한 credential을 사용자의 Mac에 암호화해 저장하며, terminal이 없는 caller는 이미 저장된 credential에 의존합니다. hosted OAuth, bearer token, cloud account 또는 remote authentication endpoint는 없습니다. 상세한 lock-mode와 non-interactive 동작은 usage 문서의 authentication 절을 따릅니다.
MCP 문서에 있는 kmsg mcp-server command는 stdio transport로 kmsg_read, kmsg_send, kmsg_send_image tool을 노출합니다. MCP client는 installed binary를 command로 실행하고 JSON-RPC를 standard input/output으로 교환합니다. 현재 first-party Streamable HTTP MCP endpoint나 /.well-known/mcp live handshake는 제공하지 않습니다. GitHub Pages는 static host이므로 POST 기반 MCP session을 가장하지 않습니다.
/.well-known/mcp
실시간 message event는 kmsg watch --json을 별도 local process로 실행해 한 줄당 JSON object로 받습니다. kmsg는 public webhook delivery service나 callback registration API를 운영하지 않습니다. 외부 workflow가 webhook을 필요로 하면 사용자가 관리하는 supervisor가 local watch event를 검증하고 승인 정책을 적용한 뒤 자신의 endpoint로 전달해야 합니다. repository에는 제3자 webhook credential을 저장하지 마세요.
kmsg watch --json
Architecture는 Accessibility wrapper, KakaoTalk domain service, command layer, cache와 MCP adapter의 경계를 설명합니다. source build는 Swift 6을 사용하며 release version은 repository VERSION과 tag로 관리합니다. contribution 전에는 current issue, tests, release policy를 확인하고 message send처럼 외부 상태를 바꾸는 변경에는 dry-run 또는 explicit confirmation 경계를 유지하세요.
kmsg is an unofficial open-source KakaoTalk CLI and native MCP server for macOS. It reads, watches, and sends text or images by using the public macOS Accessibility API against the visible KakaoTalk desktop application. It does not implement or bypass KakaoTalk's private LOCO protocol.
The project is for developers automating work on a Mac they control, local tools that need structured KakaoTalk results, and AI agents that operate under a user's approval. kmsg is not a hosted messaging SaaS or a bulk-send service. Its commands run locally, require KakaoTalk for macOS, and expose observable command, JSON, and MCP contracts.
CHANN maintainer Park Hee Chan develops kmsg in the public channprj/kmsg GitHub repository. Source, issues, releases, MIT License terms, and CI history are reviewable. The canonical website is https://channprj.github.io/kmsg/; installation and release claims link back to the same repository.
KakaoTalk account data and messages are processed on the user's Mac and are not uploaded to this static website. Commands that change external state should be previewed with --dry-run, and callers must verify the target and payload. Accessibility permission, desktop login state, background-safe reads, bounded UI search, encrypted local credentials, and explicit MCP tool schemas define what the tool can do.
kmsg is independent and is not affiliated with or endorsed by Kakao Corp. Desktop UI changes can affect automation, so users remain responsible for permissions, message results, and applicable policies. The project makes its limitations visible rather than claiming unverified organizational scale or service guarantees.
Use the public GitHub repository for kmsg bug reports, feature requests, setup questions, and MCP integration help. Public issues create a searchable record tied to source revisions and releases. The project does not operate a paid help desk, telephone support line, or guaranteed response-time service.
Open an issue at GitHub Issues. Include the kmsg, macOS, and KakaoTalk versions; the command you ran; expected and actual behavior; and a minimal reproduction. Before attaching Accessibility output or logs, remove names, chat text, phone numbers, account identifiers, local paths, credentials, and keys. Prefer synthetic examples to real private messages.
Describe the real job a proposed command, JSON field, MCP tool, or document should solve. State side effects, approval boundaries, and expected failure behavior. Check the developer resources, architecture, current issues, and release notes first so the discussion can build on existing contracts.
Do not publish a sensitive vulnerability or private personal data in a public issue. Send the minimum necessary report to iam@chann.dev with kmsg security or kmsg privacy in the subject. Include affected versions and reproduction conditions, but never send a real KakaoTalk password, message archive, access token, or encryption key. Ordinary support may be redirected to a public issue.
The official source is https://github.com/channprj/kmsg, the canonical site is https://channprj.github.io/kmsg/, and the maintainer profile is https://github.com/channprj. Verify binaries through GitHub Releases or the channprj/tap Homebrew tap. Changes to contact details or policy are recorded in this page and repository history.
This first-party index explains how to integrate kmsg with scripts, local automation, coding agents, and MCP clients. The public interfaces are a macOS CLI, structured JSON output, a newline-delimited event stream, and a native stdio MCP server.
The usage reference documents commands, options, environment variables, output formats, and troubleshooting. kmsg chats, kmsg read, and kmsg watch provide structured results while AX diagnostics remain on stderr. kmsg has no hosted HTTP API, REST endpoint, or OpenAPI specification; integrations invoke the installed binary as a local process.
Authentication means KakaoTalk desktop login readiness plus macOS Accessibility permission. kmsg auth login stores necessary credentials encrypted on the user's Mac. Non-interactive callers depend on previously stored credentials. There is no hosted OAuth flow, bearer token, cloud account, or remote auth endpoint.
The MCP guide documents kmsg mcp-server, a stdio server exposing kmsg_read, kmsg_send, and kmsg_send_image. Clients launch the installed binary and exchange JSON-RPC through standard input and output. kmsg currently has no first-party Streamable HTTP MCP endpoint or live /.well-known/mcp handshake; a static GitHub Pages response cannot represent a POST-based MCP session.
Run kmsg watch --json as a local process for newline-delimited message events. kmsg does not operate a hosted webhook delivery or callback registration service. If a workflow needs webhooks, an operator-owned supervisor must validate local events, apply approval policy, and deliver them to an endpoint the operator controls.
The architecture guide covers the Accessibility wrapper, KakaoTalk services, command layer, cache, and MCP adapter. Source builds use Swift 6, and releases derive from the repository VERSION and tags. Changes that send messages must preserve dry-run or explicit confirmation boundaries.
kmsgはmacOS版KakaoTalkをターミナルやAI agentから操作するための非公式オープンソースCLIおよびnative MCP serverです。公開されているmacOS Accessibility APIを使って表示中のアプリを操作し、非公開LOCO protocolは実装しません。
自分が管理するMacで作業を自動化する開発者、構造化JSONを利用するlocal tool、利用者の承認の下で動くAI agentを対象にしています。CHANNのPark Hee Chanが公開GitHub repository channprj/kmsgで保守し、source、issue、release、MIT License、CI履歴を確認できます。
KakaoTalkのaccount dataとmessageは利用者のMac上で処理され、この静的サイトへ送信されません。実際の送信前には--dry-runで対象とpayloadを確認してください。Accessibility権限、desktop login、background-safe read、暗号化されたlocal credential、明示的なMCP tool contractが操作範囲を定義します。
kmsgはKakao Corp.と提携または承認された公式製品ではありません。UI変更の影響を受ける可能性があり、利用者は権限、送信結果、関連policyを確認する責任があります。公式sourceとcanonical site、既知の制限を文書化し、確認できない保証は行いません。
バグ報告、機能提案、設定やMCP連携の質問は公開GitHub Issuesを利用してください。source revisionと解決過程が検索可能な記録として残ります。有料help desk、電話窓口、応答時間保証は提供していません。
kmsg、macOS、KakaoTalkのversion、実行したcommand、期待結果、実際のerror、最小の再現手順を記載してください。Accessibility outputやlogを添付する前に、氏名、chat本文、電話番号、account ID、local path、credential、keyを削除し、実際の個人messageではなくsynthetic dataを使用してください。
公開できない脆弱性や個人情報の問題はpublic issueへ原文を投稿せず、iam@chann.devへ必要最小限の情報を送ってください。件名にkmsg securityまたはkmsg privacyを含め、影響versionと再現条件を説明します。password、message archive、token、encryption keyは送信しないでください。
公式sourceはhttps://github.com/channprj/kmsg、canonical siteはhttps://channprj.github.io/kmsg/、maintainer profileはhttps://github.com/channprjです。binaryはGitHub Releasesまたはchannprj/tap Homebrew tapで確認してください。
kmsgをscript、local automation、coding agent、MCP clientへ接続するためのfirst-party索引です。public interfaceはmacOS CLI、structured JSON、改行区切りevent stream、native stdio MCP serverです。
利用ガイドにcommand、option、environment variable、JSON output、local credential、lock modeを掲載しています。kmsg authenticationはKakaoTalk desktop loginとmacOS Accessibility権限を確認するlocal flowです。hosted OAuth、bearer token、cloud accountはありません。
MCPガイドのkmsg mcp-serverはstdio transportでkmsg_read、kmsg_send、kmsg_send_imageを公開します。現在Streamable HTTP endpointやlive /.well-known/mcp handshakeはありません。static GitHub PagesでPOST based MCP sessionを装うことはしません。
kmsgはhosted HTTP API、REST/OpenAPI specification、public webhook deliveryを提供しません。kmsg watch --jsonをlocal processとして実行するとmessage eventを受け取れます。webhookが必要な場合は利用者が管理するsupervisorでeventを検証し、approval policyを適用してから自分のendpointへ転送します。
ArchitectureはAccessibility wrapper、domain service、command、cache、MCP adapterを説明します。source buildはSwift 6を利用し、送信変更ではdry-runまたは明示的confirmationを維持します。
kmsg是面向macOS版KakaoTalk的非官方开源CLI与native MCP server。它通过公开的macOS Accessibility API操作可见桌面应用，用于读取、监控以及发送文本或图片，不实现也不绕过KakaoTalk私有LOCO protocol。
项目服务于在自己控制的Mac上进行自动化的开发者、需要结构化JSON的local tool，以及在用户批准下工作的AI agent。CHANN维护者Park Hee Chan在公开GitHub仓库channprj/kmsg开发项目，source、issue、release、MIT License与CI记录均可核查。
KakaoTalk账户资料和message在用户Mac本地处理，不会上传到本静态网站。真实发送前应使用--dry-run核对目标和payload。Accessibility权限、desktop login状态、background-safe read、本地加密credential以及明确的MCP tool contract限定了工具行为。
kmsg并非Kakao Corp.关联、认可或官方产品。桌面UI变化可能影响自动化，用户需要自行确认权限、发送结果与适用policy。项目通过公开source、canonical site、可复现test与已知限制建立信任，不宣称无法验证的组织规模或服务保证。
错误报告、功能建议、安装问题与MCP集成咨询请使用公开的GitHub Issues。公开issue可与source revision、release和解决过程关联并供其他用户检索。项目不提供付费客服、电话支持或保证响应时间。
请提供kmsg、macOS和KakaoTalk版本，执行的command，预期与实际结果，以及最小复现步骤。上传Accessibility output或log前，必须删除姓名、chat内容、电话号码、account ID、local path、credential与key。请使用synthetic data替代真实私人message。
不应公开的漏洞或个人资料问题不要发布在public issue。请将最少必要信息发送到iam@chann.dev，主题写明kmsg security或kmsg privacy，并说明受影响version与复现条件。不要发送真实KakaoTalk password、message archive、access token或encryption key。
官方source是https://github.com/channprj/kmsg，canonical site是https://channprj.github.io/kmsg/，maintainer profile是https://github.com/channprj。binary应通过GitHub Releases或channprj/tap Homebrew tap核验。
本页汇集将kmsg接入script、local automation、coding agent与MCP client所需的first-party文档。public interface包括macOS CLI、structured JSON、按行输出的event stream，以及native stdio MCP server。
使用指南说明command、option、environment variable、JSON output、本地credential与lock mode。kmsg authentication是KakaoTalk desktop login加macOS Accessibility权限的local flow，不提供hosted OAuth、bearer token、cloud account或remote auth endpoint。
MCP指南中的kmsg mcp-server通过stdio transport公开kmsg_read、kmsg_send和kmsg_send_image。目前没有first-party Streamable HTTP endpoint或live /.well-known/mcp handshake；静态GitHub Pages不能代表POST based MCP session。
kmsg不提供hosted HTTP API、REST/OpenAPI specification或public webhook delivery。运行local process kmsg watch --json可获得message event。如果workflow需要webhook，用户管理的supervisor应验证event、执行approval policy，然后发送到用户控制的endpoint。
Architecture说明Accessibility wrapper、domain service、command layer、cache与MCP adapter。source build使用Swift 6，任何发送相关变更都应保留dry-run或明确confirmation边界。
Continue to kmsg
404
The requested page does not exist. Choose a language to return to kmsg.
# kmsg 404 + +The requested path does not exist. Continue with one of these resources: + +- [Home](${baseUrl}) +- [Agent index](${baseUrl}llms.txt) +- [Sitemap](${baseUrl}sitemap.xml) +- [MCP documentation](${baseUrl}mcp/)