axmap-cli 1.3.0 → 1.3.2

package/.claude/commands/ax-setup.md

@@ -1,20 +1,18 @@
 ---
-description: axMap — 이 저장소에 axMap 을 붙인다 (내 git 주소를 넣어 초기화)
+description: axMap — 어느 폴더에서든 이 PC에 전역 설치·등록한다
 ---
 
-이 저장소에서 axMap 선점을 쓸 수 있게 만들어줘.
-장부(누가 무엇을 잡고 있는지 적는 곳)를 둘 git 주소: $ARGUMENTS
+이 PC에서 axMap을 전역으로 사용할 수 있게 설정해줘.
+추가 setup 옵션: $ARGUMENTS
 
-1. 지금 폴더가 git 저장소인지 먼저 본다. 아니면 **여기서 멈추고** 사람에게 알린다.
-   axMap 의 장부와 쪽지는 git 의 고아 브랜치로 오간다 — 저장소가 없으면 claim 이
-   아무에게도 안 가면서 조용히 성공한다.
+1. 지금 폴더가 Git 저장소가 아니어도 진행한다. setup은 PC 전역 설치이며 작업 repo는 나중에 CLI를 켠 위치에서 결정한다.
 
 2. Bash 로 아래를 실행한다.
 
-       npx -y axmap-cli@latest setup --remote $ARGUMENTS
+       npx -y axmap-cli@latest setup $ARGUMENTS
 
-   주소를 안 줬으면 `--remote` 째로 빼고 부른다. 그러면 이 저장소의 원격을
-   그대로 쓴다 (하나면 그것, `origin` 이 있으면 `origin`).
+   추가 옵션이 없으면 setup만 실행한다. repo를 지정하거나 현재 폴더를 타겟으로 저장하지 않는다.
+   사용자가 특정 repo의 장부와 커밋 훅까지 미리 준비하길 요청한 경우에만 `--repo <경로>`를 지정한다.
 
    먼저 무엇이 바뀔지만 보고 싶으면 `--dry-run` 을 붙인다. 아무것도 쓰지 않는다.
 
@@ -25,7 +23,6 @@ description: axMap — 이 저장소에 axMap 을 붙인다 (내 git 주소를
    - AI CLI 를 **완전히 껐다가 다시 켜야** MCP 도구(`ax_*`)가 뜬다
    - 그 뒤 `/ax-start` 로 시작하면 된다
 
-이미 붙어 있는 저장소라면 `setup` 을 다시 부르지 않고 `ax_status` 로 확인만 한다 —
-`setup` 은 몇 번 돌려도 안전하지만, 이미 되는 것을 다시 설치하는 것은 시간 낭비다.
+설치·업데이트 때 setup을 한 번 실행한다. 이후 repo를 옮길 때는 setup이나 init을 반복하지 않고 그 repo에서 `ax_status` 또는 `ax_claim`을 호출한다.
 
-같은 주소를 넣은 사람끼리 서로의 선점이 보인다. 그게 이 명령이 하는 일의 전부다.
+각 repo의 장부는 첫 조회·선점 때 자동 준비하며, 같은 원격 장부를 공유하는 세션끼리 서로의 선점이 보인다.

package/README.ko.md

@@ -13,22 +13,28 @@ npm 패키지 이름은 `axmap-cli`, 실행 명령은 `axmap`이다.
 
 ## 설치
 
-사용할 git 저장소에서 실행한다.
+Git 저장소 밖을 포함해 어느 폴더에서든 실행한다.
 
 ```bash
 npm install -g axmap-cli@latest
-cd <프로젝트-저장소>
 axmap setup
-axmap doctor
 ```
 
-`setup`은 저장소의 선점 장부와 커밋 훅을 준비하고, AI 도구의 사용자 설정에 MCP를 등록한다.
+`setup`은 이 PC에 axMap을 설치하고 AI 도구의 사용자 설정에 MCP를 등록한다. 실행한 폴더에 타겟을 고정하거나 repo를 초기화하지 않는다.
 MCP를 사용하려면 설정 후 AI 도구를 다시 시작한다.
 함께 작업하는 사람과 에이전트는 같은 원격 장부를 사용해야 서로의 선점을 볼 수 있다.
 
+## 1.3.2: 쪽지 표시 이름과 사용자 자동 공유
+
+대화형 `setup`에서 `장효준`, `John Smith`처럼 쪽지에 표시할 이름을 입력한다. 입력 없이 설정하거나 오타를 고치려면 `axmap setup --name "장효준"`을 실행한다. 재설치할 때는 저장된 이름을 유지하며 Git 이름·이메일 설정은 바꾸지 않는다.
+
+각 repo에서 axMap을 처음 사용하면 해당 repo의 Git 이메일을 읽고 기존 `axmap/users` 고아 브랜치에 표시 이름을 자동 공유한다. 코드 커밋이나 repo별 수동 등록은 필요 없다. 다른 팀원은 사용자 정보 동기화 후 수신자로 발견한다. 원격 push 권한이 필요하며, 공유 실패는 경고하고 다음 사용 때 재시도한다. `setup`만 실행하고 사용한 적 없는 repo에는 등록하지 않는다.
+
+`axmap bus contacts`로 수신자 이름·이메일을 확인한다. 아는 이름으로 보낸 쪽지는 이메일 주소로 저장하므로 이름을 고쳐도 수신·읽음 기록이 이어진다. 동명이인은 이메일로 지정한다. 쪽지 자동 등록은 투표권이나 MR 승인 권한을 부여하지 않는다.
+
 자세한 설치·설정은 [docs/INSTALL.md](https://github.com/rl2aderjoon/axmap/blob/main/docs/INSTALL.md)를 참고한다.
 
-## 1.3.0: repo를 옮겨도 init 없이 사용
+## 1.3.1: 어느 폴더에서든 setup 한 번, 이후 repo 자동 연결
 
 axMap을 한 번 설정하면 다른 Git 저장소에서도 Codex 등 AI CLI를 열어 바로 사용할 수 있다. 세션의 작업 repo를 자동으로 선택하고, 첫 조회·선점 때 장부를 준비하므로 매번 `axmap init`을 실행하지 않아도 된다.
 
@@ -36,14 +42,14 @@ axMap을 한 번 설정하면 다른 Git 저장소에서도 Codex 등 AI CLI를
 
 MCP는 클라이언트가 알려주는 작업 폴더(roots)를 따라간다. 미지원 클라이언트는 시작 폴더를 사용하며, 도중에 폴더를 바꾸면 도구의 `cwd`에 작업 폴더 절대 경로를 전달한다. 커밋 훅을 적용할 새 repo에서는 `axmap hook install`을 실행한다.
 
-기존 설치를 업그레이드할 때는 작업 repo에서 아래 명령을 한 번 실행하고 AI CLI를 다시 시작한다.
+기존 설치를 업그레이드할 때도 어느 폴더에서든 아래 명령을 한 번 실행하고 AI CLI를 다시 시작한다.
 
 ```bash
 npm install -g axmap-cli@latest
 axmap setup
 ```
 
-`setup`은 MCP와 훅이 사용하는 설치 사본 및 등록을 갱신한다. 이후 repo를 옮길 때는 setup이나 init을 반복하지 않는다.
+`setup`은 MCP와 공유 훅 실행 사본 및 등록을 갱신한다. 이후 repo를 옮길 때는 setup이나 init을 반복하지 않는다. 특정 repo의 장부와 커밋 훅까지 미리 준비하려면 `axmap setup --repo <경로>`를 명시한다.
 
 ## 작업 흐름
 

package/README.md

@@ -13,22 +13,26 @@ The npm package is `axmap-cli`; the command is `axmap`.
 
 ## Installation
 
-Run these commands in the Git repository you want to work on.
+Run these commands from any folder, including outside a Git repository.
 
 ```bash
 npm install -g axmap-cli@latest
-cd <your-project-repository>
 axmap setup
-axmap doctor
 ```
 
-`setup` prepares the repository's claim ledger and commit hooks, and registers MCP in your AI tool's user settings.
+`setup` installs axMap and registers MCP in your AI tool's user settings. It does not bind the installation to the current folder or initialize a repository.
 Restart your AI tool after setup to use MCP.
 People and agents working together must share the same remote ledger to see each other's claims.
 
+During interactive setup, enter the name people should use for messages, such as `John Smith` or `장효준`. To set or correct it without a prompt, run `axmap setup --name "John Smith"`. Reinstallation keeps the saved name. Git's name and email settings are unchanged.
+
+On first use in a repository, axMap reads that repository's Git email and shares your display name through the existing `axmap/users` branch. No code commit or per-repository manual registration is needed. Teammates discover it when their user information synchronizes. This requires push access; an offline or rejected update is reported and retried. Setup alone does not announce you to repositories you have never used.
+
+Use `axmap bus contacts` to list known names and email addresses. Messages sent to a known name are addressed to its email, so correcting the name preserves delivery and read history. If multiple people use the same name, specify the recipient's email. Messaging registration does not grant voting or MR approval rights.
+
 See [docs/INSTALL.md](https://github.com/rl2aderjoon/axmap/blob/main/docs/INSTALL.md) for installation and configuration details (Korean).
 
-## Automatic repository setup in 1.3.0
+## Global setup and automatic repositories in 1.3.1
 
 Set up axMap once, then open Codex or another AI CLI in any Git repository. axMap selects that session's repository and prepares its ledger on the first status or claim request. There is no per-repository `axmap init` step.
 
@@ -36,14 +40,14 @@ Existing remote ledgers are reused. Linked worktrees share one ledger, and simul
 
 MCP follows workspace roots supplied by the client. When roots are unsupported, it uses the launch directory; pass the absolute working directory through the tool's `cwd` argument for later directory changes. Run `axmap hook install` in each repository where you want commit enforcement.
 
-To upgrade an existing installation, run this once from a working repository, then restart your AI CLI:
+To upgrade an existing installation, run this once from any folder, then restart your AI CLI:
 
 ```bash
 npm install -g axmap-cli@latest
 axmap setup
 ```
 
-`setup` refreshes the installed MCP and hook copy as well as its registration. Subsequent repository changes do not require another setup or init.
+`setup` refreshes the installed MCP and shared hook runner as well as its registration. Subsequent repository changes do not require another setup or init. To explicitly prepare one repository and its commit hook during setup, use `axmap setup --repo <path>`.
 
 ## Workflow
 

package/bin/axmap.mjs

@@ -47,6 +47,7 @@ import { stateDir } from '../src/repotarget.mjs'
 import { homeRegistrations } from '../src/mcpstate.mjs'
 import { compareBranchFor, formatOverlap } from '../src/overlap.mjs'
 import { withRepoLock } from '../src/repolock.mjs'
+import { readProfile, syncConfiguredProfile } from '../src/identity.mjs'
 
 /** 이 CLI 가 들어 있는 axMap 폴더. 갱신 확인과 setup 이 자기 위치를 알아야 한다. */
 const SELF_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
@@ -453,9 +454,17 @@ function unreadNotes(root, me) {
   }
   if (!found.length) return []
   let seen = ''
+  const email = (process.env.AXMAP_AGENT_EMAIL || git(['config', 'user.email'], { cwd: root }).out).trim().toLowerCase()
+  const mine = new Set([me.toLowerCase(), email].filter(Boolean))
+  try { const p = readProfile(); if (p) mine.add(p.name.toLowerCase()) } catch { /* profile sync reports it */ }
+  try {
+    const state = JSON.parse(fs.readFileSync(path.join(usersFilesDir(root), `${email}.json`), 'utf8'))
+    for (const n of [state.name, ...(state.aliases ?? [])]) if (n) mine.add(n.toLowerCase())
+    seen = state.seen ?? ''
+  } catch { /* no shared state */ }
   try {
     const raw = JSON.parse(fs.readFileSync(path.join(root, '.axmap-bus-seen.json'), 'utf8'))
-    seen = raw[me] ?? ''
+    for (const [key, id] of Object.entries(raw)) if (mine.has(key.toLowerCase()) && id > seen) seen = id
   } catch { /* 처음이면 아무것도 안 읽은 것 */ }
 
   const out = []
@@ -471,8 +480,8 @@ function unreadNotes(root, me) {
     const from = g('from')
     const to = g('to')
     // 내가 보낸 것은 뺀다 — 자기 쪽지에 자기가 놀라면 안 된다.
-    if (from === me) continue
-    if (to !== me && to !== 'all') continue
+    if (g('fromEmail') ? mine.has(g('fromEmail').toLowerCase()) : mine.has(from.toLowerCase())) continue
+    if (!to.split(',').some((v) => v.trim().toLowerCase() === 'all' || mine.has(v.trim().toLowerCase()))) continue
     out.push({ id, from, subject: g('subject') })
   }
   return out
@@ -504,6 +513,11 @@ function markBusSeen(root, me, id) {
     all[me] = id
     fs.writeFileSync(file, JSON.stringify(all, null, 2) + '\n')
   } catch { /* 조용히 */ }
+  // Use the same email-keyed receipt as MCP, while retaining the legacy file
+  // for older installations that still share this checkout.
+  spawnSync(process.execPath, [path.join(SELF_ROOT, 'tools', 'bus.mjs'), 'seen', '--mine', id], {
+    cwd: root, env: { ...process.env, AXMAP_AGENT: me }, encoding: 'utf8', windowsHide: true,
+  })
 }
 
 /**
@@ -722,18 +736,10 @@ function claimsDir(root) {
   return path.join(ledgerDir(root), 'claims')
 }
 
-/**
- * 쪽지함은 **일부러 `root` 그대로 둔다.**
- *
- * 장부와 같은 `.axmap/` 아래라 같은 문제가 있지만(링크된 worktree 에는 없다),
- * 고치려면 `tools/bus.mjs` 의 `SEEN_FILE`·쪽지함 경로까지 같이 옮겨야 한다.
- * 한쪽만 옮기면 **읽는 곳과 쓰는 곳이 갈려** 읽음 표시가 어긋난다 —
- * 쪽지가 안 보이는 것보다 나쁘다. 장부와 달리 여기서는 못 찾아도 죽지 않고
- * "새 쪽지 없음" 으로 조용히 지나가므로, 링크된 worktree 에서 쪽지가 안 보이는
- * 것은 남는 구멍으로 적어 둔다.
- */
+/** Message and user worktrees follow the same common checkout as the ledger.
+ * Git identity is still read from the caller's working repository. */
 function busDir(root) {
-  return path.join(root, BUS_REL)
+  return path.join(axmapHome(root), BUS_REL)
 }
 
 /** 쪽지 파일이 실제로 쌓이는 곳. 브랜치 루트에 흩뿌리지 않고 한 폴더 아래 모은다. */
@@ -742,7 +748,7 @@ function busMessagesDir(root) {
 }
 
 function usersDir(root) {
-  return path.join(root, USERS_REL)
+  return path.join(axmapHome(root), USERS_REL)
 }
 
 /** 사람마다의 파일이 쌓이는 곳. `.gitattributes` 와 섞이지 않게 한 폴더 아래 모은다. */
@@ -1343,9 +1349,17 @@ function ensureOrphan(root, { branch, rel, dir, what, seed }) {
   const remote = r.source === 'ambiguous' ? null : r.name
 
   let base = null
-  if (remote && git(['fetch', '--quiet', remote, branch], { cwd: root }).code === 0) {
-    base = git(['rev-parse', 'FETCH_HEAD'], { cwd: root }).out
-  } else {
+  if (r.source === 'ambiguous') return fail({ err: '원격이 모호합니다. git config axmap.remote <원격>을 지정하세요.' })
+  if (remote) {
+    const exists = git(['ls-remote', '--exit-code', remote, `refs/heads/${branch}`], { cwd: root })
+    if (exists.code !== 0 && exists.code !== 2) return fail(exists)
+    if (exists.code === 0) {
+      const fetched = git(['fetch', '--quiet', remote, branch], { cwd: root })
+      if (fetched.code !== 0) return fail(fetched)
+      base = git(['rev-parse', 'FETCH_HEAD'], { cwd: root }).out
+    }
+  }
+  if (!base) {
     // 빈 트리 -> 부모 없는 커밋 -> 브랜치. 작업 트리를 건드리지 않는 고아 브랜치.
     const tree = git(['mktree'], { cwd: root, input: '' })
     if (tree.code !== 0) return fail(tree)
@@ -1361,6 +1375,8 @@ function ensureOrphan(root, { branch, rel, dir, what, seed }) {
   const w = git(['worktree', 'add', '--quiet', dir, branch], { cwd: root })
   if (w.code !== 0) return fail(w)
 
+  excludeAxmap(root)
+
   seed(dir)
 
   // 🔴 고아 브랜치는 **자기 트리의 `.gitattributes` 만** 본다. 저장소 루트에
@@ -1386,6 +1402,16 @@ function ensureOrphan(root, { branch, rel, dir, what, seed }) {
   return 'created'
 }
 
+function excludeAxmap(root) {
+  const file = path.resolve(root, gitOrDie(['rev-parse', '--git-path', 'info/exclude'], { cwd: root }).out)
+  fs.mkdirSync(path.dirname(file), { recursive: true })
+  let text = fs.existsSync(file) ? fs.readFileSync(file, 'utf8') : ''
+  for (const entry of ['.axmap/', '.axmap-bus-seen.json']) {
+    if (!text.split(/\r?\n/).includes(entry)) text += (text && !text.endsWith('\n') ? '\n' : '') + entry + '\n'
+  }
+  fs.writeFileSync(file, text)
+}
+
 function ensureBus(root) {
   return ensureOrphan(root, {
     branch: BUS_BRANCH, rel: BUS_REL, dir: busDir(root), what: '쪽지함',
@@ -1424,7 +1450,7 @@ function cmdBusRepair() {
   const root = repoRoot()
   // .axmap 을 손으로 지웠어도 git 쪽에 worktree 등록이 남아 add 가 실패한다.
   git(['worktree', 'prune'], { cwd: root })
-  const r = ensureBus(root)
+  const r = withRepoLock(path.join(commonDir(root), 'axmap-init.lock'), () => ensureBus(root))
   if (r === 'failed') process.exit(1)
   console.log(
     r === 'ready'
@@ -1437,7 +1463,7 @@ function cmdBusRepair() {
 function cmdUsersRepair() {
   const root = repoRoot()
   git(['worktree', 'prune'], { cwd: root })
-  const r = ensureUsers(root)
+  const r = withRepoLock(path.join(commonDir(root), 'axmap-init.lock'), () => ensureUsers(root))
   if (r === 'failed') process.exit(1)
   console.log(
     r === 'ready'
@@ -2778,7 +2804,7 @@ function warnIfStale() {
 
 const HELP = `axmap - AI 에이전트 작업 선점 프로토콜
 
-  axmap setup                        이 PC 와 이 저장소에 axMap 을 붙인다 (첫 한 번)
+  axmap setup                        어느 폴더에서든 이 PC에 전역 설치·등록한다 (첫 한 번)
                                         [--remote <이름|git 주소>] [--name] [--dry-run]
   axmap init                         장부(고아 브랜치 + worktree)를 준비한다
   axmap bus-repair                   쪽지함만 준비한다 (장부는 안 건드린다)
@@ -2898,3 +2924,12 @@ switch (cmd) {
     console.log(HELP)
     process.exit(cmd ? 1 : 0)
 }
+
+// Setup stores a label, never a repository pin. Publish it only after an
+// actual successful collaboration command in the selected working repository.
+if (['init', 'claim', 'release', 'renew', 'status'].includes(cmd)) {
+  const warning = syncConfiguredProfile(process.cwd(), path.join(SELF_ROOT, 'tools', 'bus.mjs'), {
+    ...process.env, ...(flags.agent ? { AXMAP_AGENT: flags.agent } : {}),
+  })
+  if (warning) console.error(warning)
+}

package/mcp/README.md

@@ -11,15 +11,14 @@
 
 ## 설치
 
-Node 20 이상과 git이 필요하다. 사용하려는 git 저장소에서 실행한다.
+Node 20 이상과 git이 필요하다. Git 저장소 밖을 포함해 어느 폴더에서든 실행한다.
 
 ```bash
 npm install -g axmap-cli@latest
 axmap setup
-axmap doctor
 ```
 
-설정 후 AI CLI를 다시 시작한다. `setup`은 AI CLI의 사용자 설정에 MCP를 등록하고 대상 저장소의 장부와 커밋 훅을 준비한다. 소스 개발 환경에서는 `node bin/axmap.mjs setup`을 사용한다.
+어느 폴더에서든 setup을 실행한 뒤 AI CLI를 다시 시작한다. `setup`은 PC 전역에 MCP와 명령을 설치·등록하며 repo를 초기화하거나 타겟으로 저장하지 않는다. 이후 AI CLI를 켠 repo에서 장부를 자동 준비한다. 소스 개발 환경에서는 `node bin/axmap.mjs setup`을 사용한다. 명시적 repo 준비는 `setup --repo <경로>`를 사용한다.
 
 AI에게 설치를 맡기려면 다음 공개 문서를 제공한다.
 
@@ -73,7 +72,7 @@ Claude Code 에서는 `/ax`, `/ax-start`, `/ax-done`, `/ax-tell` 로도 부른
 | Claude Code (`claude`) | `~/.claude.json` 의 user 범위 (**이 PC 의 모든 폴더에 적용되는 개인 설정**) | 설치기가 `claude mcp add -s user` 로 | ✅ 이 PC 에서 확인 |
 | Claude Code (`claude`) | 저장소의 `.mcp.json` | 저장소에 들어 있으면 스스로 발견 | ✅ 이 저장소가 그렇게 쓴다 |
 | Antigravity (`agy`) | `~/.gemini/config/mcp_config.json` (전역, `mcpServers`) | `tools/mcp-register.mjs` | ✅ `agy` 1.1.10 으로 확인 |
-| Codex (`codex`) | `~/.codex/config.toml` (전역, `[mcp_servers.axmap]`) | `tools/mcp-register.mjs` 가 `codex mcp add` 로 | ⚠️ 문서로만 확인, 실물 미확인 |
+| Codex (`codex`) | `~/.codex/config.toml` (전역, `[mcp_servers.axmap]`) | `tools/mcp-register.mjs`가 Codex CLI로 등록·검증 | 임시 사용자 환경에서 실제 CLI 등록과 repo별 MCP 실행 확인 |
 
 `agy` 에서 확인한 것: 전역 파일은 먹고, 저장소의 `.mcp.json` 은 **안 먹는다.**
 공식 문서의 작업 폴더용 `.agents/mcp_config.json` 도 CLI 에서는 안 먹었다(IDE 쪽으로 보인다).
@@ -163,11 +162,7 @@ clone 하면 장부에는 `claude` 라는 **한 명**만 존재하고, 겹침
 3. OS 사용자 이름
 4. 호스트 이름
 
-**이름은 설치기를 켠 폴더의 git 설정에서 나온다.** git 은 저장소 안이면 그 저장소의
-`user.name` 을, 밖이면 전역 값을 답한다. 그래서 앞으로 일할 저장소 안에서 설치하는
-것이 맞다 — 그래야 MCP 가 쓰는 이름과 같은 저장소에서 손으로 `axmap` 을 칠 때의
-이름이 같아진다. 다르면 한 사람이 장부에서 둘이 되고, **자기가 잡은 것을 자기가
-반납하지 못한다**(`release` 종료 코드 5).
+**기본 전역 setup의 이름은 전역 Git 설정에서 정한다.** setup을 실행한 repo의 로컬 이름을 다른 repo에 가져가지 않는다. 명시적 프로젝트 설정에서는 해당 repo의 이름을 사용할 수 있다. 선점부터 반납까지 같은 이름·세션을 사용해야 한다.
 
 이름 검증은 설치기가 다시 짜지 않고 저장소의 `agentNameError()` 를 그대로 부른다.
 설치기가 통과시킨 이름을 서버가 거부하는 일이 없어야 하기 때문이다.
@@ -207,16 +202,9 @@ clone 하면 장부에는 `claude` 라는 **한 명**만 존재하고, 겹침
 
 ## 안 되는 것 / 아직 확인 못 한 것
 
-**Codex 는 실물로 확인하지 못했다.** 이 팀에 `codex` 가 깔린 PC 가 아직 없다.
-`~/.codex/config.toml` 형식은 공식 문서를 따른 것이고, `mcp-register` 는
-`codex mcp --help` 를 먼저 찔러 보고 그 하위 명령이 실제로 있을 때만 등록한다.
-TOML 을 직접 파싱하지도 쓰지도 않는다 — 어설픈 파서가 남의 `config.toml` 을 깨뜨리는
-것이 이 작업에서 나올 수 있는 최악의 결과다.
+**Codex CLI 등록은 임시 사용자 환경에서 실제 실행으로 확인했다.** `codex mcp list --json`으로 서버 경로·환경·시작 cwd를 확인하고 `codex mcp add`로 갱신한 뒤 다시 검증한다. TOML을 직접 파싱하거나 덮어쓰지 않는다. 모델 클라이언트별 roots 지원 여부는 별도 확인이 필요하다.
 
-**Codex 에는 이름이 안 들어간다.** `mcp-register` 가 `codex mcp add` 를 부를 때
-`AXMAP_AGENT` 를 빼고 부르고, 이미 등록돼 있으면 다시 부르지도 않는다. 그래서 설치기는
-codex 에 대해서는 **확인만 하고 이름은 손으로 넣으라고 한 줄 찍는다.** 확인 안 된
-도구의 설정을 추측으로 덮어쓰는 것보다 낫다고 봤다.
+**개인 환경값은 보존한다.** Codex의 기존 `AXMAP_AGENT` 등 개인 환경값은 유지하며, 전역 setup은 예전 서버 경로·고정 `AXMAP_REPO`·시작 cwd를 제거한다. 이름을 따로 지정하지 않았으면 MCP가 작업 repo의 Git 설정에서 정한다.
 
 **MCP `roots`는 1.3.0부터 지원한다.** 클라이언트가 지원을 선언하면 `roots/list`로 작업 폴더를 받고 변경 알림도 처리한다. 지원하지 않는 클라이언트는 시작 repo를 사용하고, 실행 중 경로 변경은 도구의 `cwd`로 전달한다. 프로토콜 회귀 테스트로 검증했으며 클라이언트별 실제 지원 여부는 별도 확인이 필요하다.
 

package/mcp/SETUP-FOR-AI.md

@@ -8,15 +8,14 @@ Node 20 이상과 git을 확인한다. npm 패키지 이름은 `axmap-cli`다.
 npm install -g axmap-cli@latest
 ```
 
-사용자가 지정한 git 저장소에서 다음 명령을 실행한다. 대상 저장소가 불분명하면 먼저 확인한다.
+Git 저장소 밖을 포함해 어느 폴더에서든 다음 명령을 실행한다. setup에는 작업 repo를 지정할 필요가 없다.
 
 ```bash
 axmap setup --dry-run
 axmap setup
-axmap doctor
 ```
 
-`setup`은 AI CLI의 사용자 설정에 MCP를 등록하고 대상 저장소에 장부와 훅을 만든다. 전역 MCP 등록에 `AXMAP_REPO`를 특정 폴더로 고정하지 않는다. 다른 원격을 공유하려면 `--remote <git-주소>`를 명시한다.
+`setup`은 프로그램과 전역 명령을 설치하고 AI CLI의 사용자 설정에 MCP를 등록한다. repo를 초기화하거나 `AXMAP_REPO`를 특정 폴더로 고정하지 않는다. repo의 장부와 커밋 훅도 미리 준비하려면 `--repo <경로>`를 명시하고, 다른 원격을 공유하려면 `--remote <git-주소>`도 지정한다.
 
 1.3.0부터 다른 repo로 이동할 때 `setup`이나 `init`을 반복하지 않는다. 새 작업 repo에서 AI CLI를 실행하면 첫 조회·선점 시 장부를 자동 준비한다. MCP roots가 지원되면 작업 폴더 변경도 따라간다. 지원되지 않거나 여러 repo가 열려 있으면 도구의 `cwd`에 현재 작업 폴더 절대 경로를 전달한다. 커밋 훅을 새 repo에도 적용하려면 `axmap hook install`을 실행한다.
 

package/mcp/install.ps1

@@ -228,6 +228,7 @@ if (-not (Test-Path -LiteralPath $server)) { Fail "복사가 끝났는데 서버
 # 이미 한다. 여기서 다시 짜지 않는다.
 Say ''
 & node (Join-Path $Dest 'tools\mcp-register.mjs')
+if ($LASTEXITCODE -ne 0) { Fail 'AI CLI 전역 등록을 확인하지 못했습니다. 위 오류를 해결하고 setup을 다시 실행하세요.' }
 Say '      (위에 claude 가 ".mcp.json 이 없습니다" 로 나왔다면, 그건 "저장소 안의'
 Say '       .mcp.json" 을 찾는 검사입니다. 전역 설치에는 그 파일이 없는 것이 정상이고,'
 Say '       Claude Code 는 바로 아래에서 따로 등록합니다.)'
@@ -295,7 +296,7 @@ if (-not (Get-Command codex -ErrorAction SilentlyContinue)) {
   $listed = "$(& codex mcp list)"
   if ($listed -match 'axmap') {
     $stCodex = 'ok'
-    $whyCodex = "~/.codex/config.toml (codex mcp list 로 확인). 이름은 손으로 넣으세요: [mcp_servers.axmap.env] 아래에 AXMAP_AGENT = ""$Name"""
+    $whyCodex = '~/.codex/config.toml (codex mcp list로 확인). 작업 repo는 실행 위치에서 결정하고 이름은 git 설정을 사용합니다.'
   } else {
     $stCodex = 'fail'; $whyCodex = 'codex mcp list 에 axmap 이 없습니다 — 위 TOML 조각을 손으로 넣으세요'
   }

package/mcp/install.sh

@@ -226,7 +226,7 @@ SERVER="$DEST/mcp/server.mjs"
 # 이 PC 에 어떤 CLI 가 있는지 찾고 각자의 설정에 넣는 일은 tools/mcp-register.mjs 가
 # 이미 한다. 여기서 다시 짜지 않는다.
 say ''
-node "$DEST/tools/mcp-register.mjs"
+node "$DEST/tools/mcp-register.mjs" || fail 'AI CLI 전역 등록을 확인하지 못했습니다. 위 오류를 해결하고 setup을 다시 실행하세요.'
 say '      (위에 claude 가 ".mcp.json 이 없습니다" 로 나왔다면, 그건 "저장소 안의'
 say '       .mcp.json" 을 찾는 검사입니다. 전역 설치에는 그 파일이 없는 것이 정상이고,'
 say '       Claude Code 는 바로 아래에서 따로 등록합니다.)'
@@ -293,7 +293,7 @@ if ! command -v codex >/dev/null 2>&1; then
 else
   if codex mcp list 2>/dev/null | grep -q axmap; then
     ST_CODEX='ok'
-    WHY_CODEX="~/.codex/config.toml (codex mcp list 로 확인). 이름은 손으로 넣으세요: [mcp_servers.axmap.env] 아래에 AXMAP_AGENT = \"$NAME\""
+    WHY_CODEX='~/.codex/config.toml (codex mcp list로 확인). 작업 repo는 실행 위치에서 결정하고 이름은 git 설정을 사용합니다.'
   else
     ST_CODEX='fail'; WHY_CODEX='codex mcp list 에 axmap 이 없습니다 — 위 TOML 조각을 손으로 넣으세요'
   fi

package/mcp/server.mjs

@@ -45,6 +45,7 @@ import fs from 'node:fs'
 import path from 'node:path'
 import readline from 'node:readline'
 import { fileURLToPath } from 'node:url'
+import { syncConfiguredProfile } from '../src/identity.mjs'
 
 const HERE = path.dirname(fileURLToPath(import.meta.url))
 
@@ -311,7 +312,7 @@ function unreadBanner(tool, text) {
   //    떼는 순간 여기가 조용히 낡는다 — 목록은 언제나 코드보다 먼저 낡는다.
   if (text.includes('안 읽은 쪽지')) return ''
 
-  const r = bus(['list', '--to', AGENT, '--unread', '--no-mark',
+  const r = bus(['list', '--mine', '--unread', '--no-mark',
     '--throttle', String(BUS_POLL), '--quiet-if-empty'])
   if (r.code !== 0) return ''
   const rows = busRows(r.out)
@@ -331,7 +332,7 @@ function unreadBanner(tool, text) {
 
   // 🔴 배너를 다 만든 뒤에 찍는다. 위에서 죽으면 안 찍혀야 다음에 다시 뜬다.
   const ids = shown.map((s) => s.id).filter(Boolean)
-  if (ids.length) bus(['seen', '--to', AGENT, ...ids])
+  if (ids.length) bus(['seen', '--mine', ...ids])
   return banner
 }
 
@@ -358,7 +359,7 @@ function cli(args) {
     cwd: REPO,
     encoding: 'utf8',
     windowsHide: true,
-    env: { ...process.env, AXMAP_AGENT: AGENT, AXMAP_ACTOR: ACTOR, AXMAP_SESSION: SESSION },
+    env: { ...process.env, AXMAP_AGENT: AGENT, AXMAP_ACTOR: ACTOR, AXMAP_SESSION: SESSION, AXMAP_SKIP_PROFILE_SYNC: '1' },
   })
   const stdout = (r.stdout ?? '').trim()
   const stderr = (r.stderr ?? '').trim()
@@ -737,7 +738,7 @@ function releaseAllIn(dir) {
     cwd: dir,
     encoding: 'utf8',
     windowsHide: true,
-    env: { ...process.env, AXMAP_AGENT: AGENT, AXMAP_ACTOR: ACTOR, AXMAP_SESSION: SESSION },
+    env: { ...process.env, AXMAP_AGENT: AGENT, AXMAP_ACTOR: ACTOR, AXMAP_SESSION: SESSION, AXMAP_SKIP_PROFILE_SYNC: '1' },
   })
   return {
     code: r.status ?? 1,
@@ -859,7 +860,7 @@ function dispatch(name, args = {}) {
       //    겹치지만 `markSeen` 은 뒤로 가지 않으므로 결과가 같다.
       //
       //    전부 보려면 `all: true` 가 이미 있다 — 그쪽은 거르지도 찍지도 않는다.
-      const a = args.id ? ['read', String(args.id)] : ['list', ...(args.all ? ['--all'] : ['--to', AGENT, '--unread'])]
+      const a = args.id ? ['read', String(args.id)] : ['list', ...(args.all ? ['--all'] : ['--mine', '--unread'])]
       const r = bus(a)
 
       // 🔴 여기도 **낸 것만 찍는다.** 목록을 자르지 않으므로 낸 것 전부다.
@@ -870,7 +871,7 @@ function dispatch(name, args = {}) {
       //    id 로 찍으면 **나에게 온 안 읽은 쪽지가 화면에 뜬 적 없이 묻힌다.**
       if (r.code === 0 && !args.id && !args.all) {
         const ids = busRows(r.out).map((s) => s.id).filter(Boolean)
-        if (ids.length) bus(['seen', '--to', AGENT, ...ids])
+        if (ids.length) bus(['seen', '--mine', ...ids])
       }
       return {
         ok: r.code === 0,
@@ -1007,7 +1008,8 @@ async function handle(req) {
       do { task = rootsTask; await task } while (task !== rootsTask)
     }
     const r = callTool(params?.name, params?.arguments ?? {})
-    return { content: [{ type: 'text', text: r.text + (r.ok ? unreadBanner(params?.name, r.text) : '') }], isError: !r.ok }
+    const warning = r.ok ? syncConfiguredProfile(REPO, BUS, { ...process.env, AXMAP_AGENT: AGENT }) : ''
+    return { content: [{ type: 'text', text: r.text + (warning ? '\n' + warning : '') + (r.ok ? unreadBanner(params?.name, r.text) : '') }], isError: !r.ok }
   }
   if (method === 'ping') return {}
   return null // 알림이거나 지원하지 않는 메서드

package/package.json

@@ -1,7 +1,7 @@
 {
   "//name": "🔴 npm 의 'axmap' 은 2022년부터 남이 쓰고 있는 다른 꾸러미다(leozin_ 의 Map 라이브러리, 1.1.2). 그래서 `npx axmap` 은 우리 것이 아니고, 누구에게도 그렇게 안내하면 안 된다. 2026-08-28 에 axmap-cli 로 정했다 — 스코프(@사용자/이름)를 쓰지 않는 이유는 스코프가 npm 계정 이름에 묶여서 나중에 팀이나 조직으로 옮길 때 이름이 통째로 바뀌기 때문이다. 사람이 치는 **명령** 이름은 그대로 axmap 이다 (아래 bin) — 꾸러미 이름과 명령 이름은 달라도 된다.",
   "name": "axmap-cli",
-  "version": "1.3.0",
+  "version": "1.3.2",
   "//private": "🔴 여기 있던 \"private\": true 를 2026-08-28 에 지웠다. 그 줄이 있는 동안 npm publish 는 거부됐다. 되돌리려면 다시 넣으면 되지만, 이미 올라간 버전은 그래도 안 사라진다 — npm 은 같은 번호를 덮어쓰지 못하고 삭제도 72시간 안에만 된다. 즉 이 줄을 되살리는 것은 '앞으로 안 올린다' 는 뜻이지 '올린 것을 없앤다' 는 뜻이 아니다.",
   "//publishConfig": "axmap-cli 는 스코프가 없어서 기본이 이미 공개다. 즉 지금은 없어도 된다. 그래도 남겨 두는 이유: 나중에 @조직/axmap 처럼 스코프를 붙이는 날 이 줄이 없으면 publish 가 '유료 플랜이 필요하다'는 엉뚱한 말로 실패한다.",
   "publishConfig": {

package/src/identity.mjs

@@ -0,0 +1,62 @@
+import fs from 'node:fs'
+import os from 'node:os'
+import path from 'node:path'
+import { spawnSync } from 'node:child_process'
+import { agentNameError } from './protocol.mjs'
+
+// Only the display name is global. Email is resolved from the working repo so
+// a work identity never silently becomes the address used in a personal repo.
+export const profilePath = (home = os.homedir()) => path.join(home, '.axmap', 'profile.json')
+
+export function displayNameError(name) {
+  if (typeof name !== 'string') return '표시 이름은 문자열이어야 합니다.'
+  return agentNameError(name) || (/[,;@\u007f]/.test(name)
+    ? '표시 이름에는 쉼표·세미콜론·@ 문자를 쓸 수 없습니다.'
+    : name.toLowerCase() === 'all' ? 'all은 전체 수신자를 뜻하므로 표시 이름으로 쓸 수 없습니다.' : null)
+}
+
+export function readProfile(home) {
+  const file = profilePath(home)
+  let data
+  try { data = JSON.parse(fs.readFileSync(file, 'utf8')) } catch (e) {
+    if (e.code === 'ENOENT') return null
+    throw new Error(`표시 이름 설정을 읽지 못했습니다: ${file} (${e.message})`)
+  }
+  const error = displayNameError(data?.name)
+  if (data?.version !== 1 || error || (data.updatedAt && !Number.isFinite(Date.parse(data.updatedAt)))) throw new Error(`표시 이름 설정이 올바르지 않습니다: ${file}${error ? ` (${error})` : ''}`)
+  return data
+}
+
+export function writeProfile(name, home) {
+  const error = displayNameError(name)
+  if (error) throw new Error(error)
+  const previous = readProfile(home)
+  const file = profilePath(home)
+  const data = { ...previous, version: 1, name,
+    updatedAt: previous?.name === name && previous.updatedAt ? previous.updatedAt : new Date().toISOString() }
+  fs.mkdirSync(path.dirname(file), { recursive: true })
+  const tmp = `${file}.tmp-${process.pid}`
+  try {
+    fs.writeFileSync(tmp, JSON.stringify(data, null, 2) + '\n', { mode: 0o600 })
+    fs.renameSync(tmp, file)
+  } finally { fs.rmSync(tmp, { force: true }) }
+  return data
+}
+
+export function emailError(email) {
+  // This address also becomes a filename on Windows; reject unsafe Git config
+  // values rather than rewriting two different addresses to the same file.
+  return typeof email !== 'string' || !/^[^\s@\\/:*?"<>|,;\u0000-\u001f]+@[^\s@\\/:*?"<>|,;\u0000-\u001f]+$/.test(email)
+    || /[.\s]$/.test(email) ? 'Git 이메일이 없거나 사용자 주소로 쓸 수 없습니다. git config user.email을 확인하세요.' : null
+}
+
+export function syncConfiguredProfile(repo, bus, env = process.env) {
+  if (env.AXMAP_SKIP_PROFILE_SYNC === '1') return ''
+  try {
+    if (!readProfile()) return ''
+    const r = spawnSync(process.execPath, [bus, 'profile'], {
+      cwd: repo, env, encoding: 'utf8', windowsHide: true,
+    })
+    return (r.stderr || (r.status !== 0 ? '경고: 쪽지 프로필 공유에 실패했습니다. 다음 사용 때 재시도합니다.' : '')).trim()
+  } catch (e) { return `경고: ${e.message}` }
+}