ai-profile-switch 2.2.0 → 2.2.2

package/README.ko.md

@@ -1,162 +1,97 @@
 # ai-profile-switch
 
 [![npm version](https://img.shields.io/npm/v/ai-profile-switch)](https://www.npmjs.com/package/ai-profile-switch)
-[![license](https://img.shields.io/npm/l/ai-profile-switch)](./LICENSE)
+[![license](https://img.shields.io/github/license/ftery0/ai-profile-switch)](./LICENSE)
 
-`CLAUDE_CONFIG_DIR`로 [Claude Code 계정](https://code.claude.com/docs/en/iam#log-in-with-multiple-accounts)을 전환합니다. 실행에 필요한 외부 패키지는 없습니다.
+회사·개인처럼 여러 Claude Code 계정을 한 컴퓨터에 두고, `claude` 를 실행할 때마다 골라 씁니다. 프로필마다 로그인·기록·설정이 따로 있고, 같이 쓸 것만 골라서 나눕니다. 실행에 필요한 외부 패키지는 없습니다.
 
 [English](./README.md) · [전체 가이드](https://ftery0.github.io/ai-profile-switch/ko/guide/)
 
-예전 이름은 `claude-account-switch` 입니다. 설치된 셸은 다음 자동 업데이트 때 이 이름으로 넘어오고, `claude-account-switch` 명령도 같은 명령의 별칭으로 남습니다. [기존 사용자](#기존-사용자)를 참고하세요.
+![claude 로 프로필을 골라 실행하고, cpf 로 바꾸고, cpf share 로 CLAUDE.md 를 나누는 데모](https://raw.githubusercontent.com/ftery0/ai-profile-switch/main/docs/assets/demo.gif)
 
-## 시작
+예전 이름은 `claude-account-switch` 입니다. [기존 사용자](#기존-사용자)를 참고하세요.
 
-Node.js 18.19+ (18계열) 또는 20.10+와 기존 Claude Code 설치를 사용합니다. Claude Code가 없다면 [공식 설치 가이드](https://code.claude.com/docs/en/setup)를 따릅니다.
+## 설치
+
+Node.js 18.19+ 또는 20.10+ 와 [Claude Code](https://code.claude.com/docs/en/setup) 가 필요합니다.
 
 ```bash
 npx ai-profile-switch@latest init
 ```
 
-프로필 이름(예: `work`, `personal`)을 정하고 기존 설정 하나를 가져올지 선택한 뒤, 새 터미널을 엽니다. `init`은 첫 설정용이며, 다시 실행하면 현재 설정만 보여줍니다.
-
-## 평소에는 두 명령만
+`work, personal` 처럼 프로필 이름을 쉼표로 적고, 새 터미널을 엽니다.
 
-`cpf`와 `claude`는 **터미널의 셸 프롬프트**(`%` 또는 `$`)에서 실행합니다. Claude 채팅창에 들어가 있다면 먼저 그곳에 `/exit`를 입력하고 터미널 프롬프트가 나올 때까지 기다립니다.
+## 평소에 쓰는 명령
 
-1. 터미널에서 `cpf`를 실행하면 조회·전환·추가·이름 변경·삭제·종료 메뉴가 열립니다.
-2. ↑/↓와 Enter로 선택합니다. 작업을 마치면 Exit를 선택해 Claude 실행 없이 터미널로 돌아옵니다.
-3. 터미널에서 `claude`를 실행하고 프로필을 고릅니다. Claude가 요청하면 로그인합니다.
-
-바로 실행하고 싶을 때는 다음 명령을 사용합니다.
+터미널 프롬프트에서 실행합니다. Claude 채팅 안이라면 먼저 `/exit` 로 나옵니다.
 
 | 명령 | 하는 일 |
 | --- | --- |
-| `cpf work` | `work`를 활성 프로필로 지정 |
-| `cpf --list` | 전체 프로필과 현재 활성 프로필 확인 |
-| `cpf add work2` | `work2` 프로필 추가 |
-| `cpf rename wrok2 work2` | `wrok2`를 `work2`로 이름 변경 |
-| `cpf remove work2` | 확인 후 `work2` 삭제 |
-| `cpf --help` | 명령어 사용법 확인 |
-
-예시의 이름은 본인의 프로필 이름으로 바꿉니다. 이름 하나만 쓰면 항상 해당 프로필로 전환합니다. `cpf add`, `cpf rename`, `cpf remove`, `cpf list`도 각각 그 이름의 프로필로 전환하므로, 목록 조회는 `cpf --list`를 사용합니다.
-
-프로필이 여러 개이면 대화형 터미널의 `claude` 실행 시 현재 활성 프로필에서 시작하는 선택기가 나옵니다. 스크립트에서는 선택기 없이 활성 프로필을 사용합니다. `--help`, `--version`을 포함한 Claude 인자는 그대로 전달됩니다. 전환은 이후 실행에 적용되며, 이미 실행 중인 Claude 세션은 기존 프로필과 계정을 유지합니다.
-
-## 계정 하나 더 추가하기
-
-1. 터미널에서 프로필을 만듭니다.
-
-   ```bash
-   cpf add work2
-   ```
-
-2. 터미널에서 Claude를 실행합니다.
-
-   ```bash
-   claude
-   ```
-
-3. 선택기에서 `work2`를 고르고, Claude가 요청하면 사용할 계정으로 로그인합니다.
-
-프로필을 만드는 것만으로 전환되거나 로그인되지는 않습니다. 명령을 외우지 않고 `cpf` 메뉴에서 추가해도 됩니다.
-
-## 원래 쓰던 기본 계정 가져오기
-
-프로필로 가져오지 않고 원래 Claude CLI를 실행하려면 Bash/zsh 터미널에서 `command claude`로 실행 함수를 우회할 수 있습니다. Claude의 기본 설정을 사용하되, `CLAUDE_CONFIG_DIR`을 따로 설정했다면 해당 경로를 사용합니다.
-
-프로필을 만드는 것만으로 기본 `~/.claude` 설정이 자동 이관되거나 로그인되지는 않습니다. 처음 `init`을 실행할 때 해당 원본과 대상 프로필을 고를 수 있습니다. 이미 프로필이 있으면 `init`은 요약만 보여주므로 별도로 이관합니다.
-
-1. 원본 또는 대상 프로필을 사용하는 Claude 세션마다 `/exit`를 입력해 종료하고 터미널로 돌아옵니다.
-2. `cpf --list`로 대상 프로필을 고릅니다. 새로 필요하면 `cpf add work`로 만듭니다.
-3. 터미널의 이 저장소 루트에서 아래 명령을 실행하고 복사를 확인합니다.
-
-   ```bash
-   node bin/cli.mjs migrate work --from ~/.claude
-   ```
-
-4. 터미널에서 `claude`를 실행하고 `work`를 선택합니다. 요청하면 로그인합니다. 예시의 `work`는 고른 프로필 이름으로 바꿉니다.
-
-원본 `~/.claude`와 `~/.claude.json`은 그대로 보존합니다. 기존 대상 데이터를 교체한 경우에도 이전 데이터는 성공 후 표시되는 백업 경로에 남깁니다. 대상 데이터 충돌이나 복사 중 대상 변경을 감지하면 이관을 중단합니다. macOS Keychain 인증은 복사하지 않으므로 설정을 가져와도 다시 로그인해야 할 수 있습니다. [자세한 이관 안내](https://ftery0.github.io/ai-profile-switch/ko/guide/commands#기존-설정-가져오기)를 참고하세요.
-
-## 프로필 이름 잘못 썼을 때
-
-이름을 바꿀 프로필을 사용하는 Claude 세션을 모두 종료한 뒤 실행합니다. 예를 들어 `wrok2` 오타를 고치려면:
+| `claude` | 계정을 골라 그 계정으로 Claude Code 실행 |
+| `cpf` | 메뉴에서 프로필 바꾸기·추가. **프로필 관리하기**에서 프로필마다 로그인 계정·사용량을 보고 이름 바꾸기·다시 로그인·지우기 |
+| `cpf work` | Claude 를 켜지 않고 `work` 로 전환 |
+| `cpf --list` | 프로필 목록과 지금 쓰는 프로필 |
+| `cpf add work2` | 프로필 만들기. 그다음 `claude` 에서 골라 로그인 |
+| `cpf rename wrok2 work2` | 이름 바꾸기. 그 프로필의 Claude 세션을 먼저 닫음 |
+| `cpf remove work2` | 확인 후 프로필 삭제 |
+| `cpf login work2` | `work2` 만 다른 Claude 계정으로 다시 로그인. 다른 프로필은 그대로 |
+| `cpf language ko` | 화면을 한국어로. `en` 은 영어, `auto` 는 시스템 설정을 따름 |
+
+- `claude` 선택 화면에는 프로필마다 이메일·요금제와, Claude Code 가 마지막으로 저장한 5시간·주간 사용량이 나옵니다. 숫자 키로 바로 고르고 Esc 로 취소합니다.
+- 화면 언어는 터미널 언어(`LANG`)나 시스템 언어를 따라 한국어·영어 중에서 정해집니다.
+- 전환은 다음 실행부터 적용됩니다. 이미 켜진 세션은 원래 계정을 그대로 씁니다.
+- 스크립트에서는 `claude` 가 묻지 않고 지금 프로필로 실행합니다.
+- Bash·zsh 프롬프트에서 `command claude` 를 치면 프로필 없이 원래 Claude 가 실행됩니다.
+- IDE 확장(VS Code, JetBrains)과 데스크톱 앱은 셸을 거치지 않아 기본 `~/.claude` 를 계속 씁니다.
+
+## 프로필끼리 설정 나누기
+
+처음에는 `settings.json` 과 `commands` 만 같이 씁니다.
 
 ```bash
-cpf rename wrok2 work2
+cpf share                 # 무엇을 나누는지, 프로필마다 맞춰져 있는지
+cpf share add CLAUDE.md   # CLAUDE.md 하나를 모든 프로필에서
+cpf share add skills      # 개인 스킬 나누기
+cpf share remove skills   # 나누기 그만. 프로필마다 복사본이 남음
 ```
 
-대화 기록·설정·목록 순서·활성 상태를 보존합니다. `work2`가 이미 있으면 중단합니다. 설정 경로가 바뀌므로 macOS에서는 다시 로그인해야 할 수 있습니다. 이름을 바꾼 뒤 새 Claude 세션을 실행하세요.
+- 나눌 수 있는 것: `CLAUDE.md` `keybindings.json` `skills` `agents` `rules` `hooks` `output-styles` `workflows` `themes`
+- 항상 프로필마다 따로: 로그인, `.claude.json`(MCP 서버·프로젝트 신뢰), 기록, `projects`, 플러그인
+- 내용이 다른 프로필 파일은 덮어쓰지 않고 경고만 합니다.
 
-## 같이 쓸 것과 따로 쓸 것
+## 원래 쓰던 계정 가져오기
 
-기본으로는 `settings.json`과 `commands`만 모든 프로필이 함께 씁니다. 나머지는 프로필마다 따로입니다. 함께 쓰고 싶은 항목은 `cpf share add`로 추가합니다.
+처음 `init` 할 때 지금 쓰는 `~/.claude` 를 프로필로 복사할 수 있습니다. 나중에 하려면 Claude 세션을 닫고 실행합니다.
 
 ```bash
-cpf share                  # 무엇을 같이 쓰는지, 프로필별로 맞는지 보기
-cpf share add CLAUDE.md    # 지금 프로필의 CLAUDE.md를 모든 프로필이 같이 씀
-cpf share add skills       # 개인 스킬을 하나씩 같이 씀
-cpf share remove skills    # 그만 같이 씀 — 각 프로필에 복사본이 남음
-cpf share sync             # _shared에 새로 넣은 항목을 지금 바로 연결
+npx ai-profile-switch@latest migrate work --from ~/.claude
 ```
 
-| 같이 쓸 수 있는 것 | 늘 프로필마다 따로 |
-| --- | --- |
-| `CLAUDE.md` `keybindings.json` `skills` `agents` `rules` `hooks` `output-styles` `workflows` `themes` | 로그인·`.claude.json`(MCP 서버·프로젝트 신뢰), 대화 기록, `projects`, 플러그인, `skills/synced`(계정에서 내려온 스킬) |
+원래 폴더는 그대로 남습니다. macOS 키체인의 로그인 정보는 복사되지 않아서, 처음 한 번 다시 로그인하라고 할 수 있습니다.
 
-- 같이 쓰는 원본은 `~/.claude-profiles/_shared/<항목>`에 있고, 각 프로필에는 링크가 놓입니다. `_shared/CLAUDE.md`를 다른 파일로 가는 링크로 바꿔도 됩니다.
-- 처음 추가할 때 `_shared`에 없으면 지금 프로필의 내용을 복사해 옵니다.
-- `claude`로 실행할 때와 새 프로필을 만들 때 링크를 다시 맞춥니다. 내용이 다른 파일이 이미 있으면 지우지 않고 경고만 합니다. 옮기거나 지운 뒤 `cpf share sync`를 실행하세요.
-- `skillOverrides`·`enabledMcpjsonServers` 같은 설정은 공유 `settings.json`에 넣으면 모든 프로필에 적용됩니다. MCP 서버 등록과 로그인은 프로필마다 `claude mcp add`·`/mcp`로 합니다.
+## 업데이트
 
-## 기존 사용자
-
-이 저장소의 변경을 사용하려면 **저장소 루트에서** 다음 명령을 실행하고 새 터미널을 엽니다.
+셸이 하루에 한 번 업데이트를 확인하고, 다음 실행부터 새 버전을 씁니다. 켜져 있는 세션에는 영향이 없습니다.
 
 ```bash
-node bin/cli.mjs install-shell
+npx ai-profile-switch@latest update          # 바로 업데이트. --check 는 확인만
+npx ai-profile-switch@latest install-shell   # 셸 명령 고치기·새로 깔기
 ```
 
-npm 배포 버전의 셸 명령어와 로컬 실행 파일을 설치·복구·갱신하려면 아래 명령을 사용하고 새 터미널을 엽니다.
-
-```bash
-npx ai-profile-switch@latest install-shell
-```
+자동 업데이트를 끄려면 `CLAUDE_SWITCH_DISABLE_AUTO_UPDATE=1` 을 설정합니다.
 
-`install-shell`은 프로필 추가나 로그인을 하지 않습니다. 기존 셸의 `cpf`에서 새 관리 명령을 쓰려면 먼저 갱신해야 합니다. 1.x 사용자도 로컬 실행 파일을 사용하도록 `install-shell`을 한 번 실행합니다. 기존 `claude-pick`은 Claude 실행 없이 활성 프로필을 고르는 명령으로 계속 지원합니다.
-
-셸은 `~/.claude-profiles/_runtime`을 사용하므로 일상적인 사용에 글로벌 설치나 임시 npx 캐시가 필요하지 않습니다. Node.js·npm·Claude Code는 계속 설치되어 있어야 합니다.
+## 기존 사용자
 
-대화형 Claude 실행 시 하루 한 번 백그라운드에서 이 도구의 새 버전을 확인합니다. 검증된 호환 버전은 다음 실행부터 사용하며, 실행 중인 세션의 파일·계정 데이터·하네스 훅·셸 설정 파일을 덮어쓰지 않습니다. 오프라인이나 다운로드 실패 시 기존 버전으로 계속 실행합니다. 비대화형 실행에서는 자동 업데이트하지 않습니다.
+`claude-account-switch` 나 1.x 를 쓰셨다면 `npx ai-profile-switch@latest install-shell` 을 한 번 실행하고 새 터미널을 엽니다. 프로필과 로그인은 그대로이고, `claude-account-switch` 명령도 별칭으로 남습니다.
 
-`CLAUDE_SWITCH_DISABLE_AUTO_UPDATE=1`로 자동 업데이트를 끌 수 있습니다. 배포 버전으로 즉시 갱신하려면 `npx ai-profile-switch@latest update`를 실행하고, 설치 없이 확인하려면 `--check`를 붙입니다. 글로벌 npm 설치본과 셸 실행 파일은 별개이며, 자동 업데이트는 셸 실행 파일만 갱신합니다. 실행 중인 세션 보호를 위해 이전 실행 파일은 보존합니다.
+## 더 보기
 
-## 전체 CLI 명령어
+- [명령어 전체와 가져오기 자세히](https://ftery0.github.io/ai-profile-switch/ko/guide/commands)
+- 플랫폼별 안내: [macOS](docs/setup-macos.ko.md) · [Linux](docs/setup-linux.ko.md) · [Windows](docs/setup-windows.ko.md)
+- 이 소스를 직접 쓰려면 레포 폴더에서 `node bin/cli.mjs install-shell` 을 실행합니다.
 
-아래 명령은 저장소 루트에서 소스를 직접 실행합니다. 배포 버전을 쓸 때는 `node bin/cli.mjs`를 `npx ai-profile-switch@latest`로 바꿉니다. 글로벌 설치를 했다면 `ai-profile-switch`를 사용할 수 있습니다.
+## 기여하기
 
-| 명령 | 용도 |
-| --- | --- |
-| `node bin/cli.mjs manage` | `cpf`와 같은 관리 메뉴 열기 |
-| `node bin/cli.mjs manage --list` | 관리 명령으로 프로필 조회 |
-| `node bin/cli.mjs init` | 첫 설정 또는 기존 설정 요약 |
-| `node bin/cli.mjs add work2` | 프로필 추가 |
-| `node bin/cli.mjs rename wrok2 work2` | 프로필 이름 변경 |
-| `node bin/cli.mjs remove work2` | 확인 후 프로필 삭제 |
-| `node bin/cli.mjs list` | 프로필과 활성 상태 조회 |
-| `node bin/cli.mjs use work` | 활성 프로필 변경 |
-| `node bin/cli.mjs migrate work --from ~/.claude` | 기존 설정을 안전하게 복사 |
-| `node bin/cli.mjs install-shell` | 셸 명령어·로컬 실행 파일 설치·복구·갱신 |
-| `node bin/cli.mjs update --check` | 배포된 새 버전을 설치 없이 확인 |
-| `node bin/cli.mjs update` | 로컬 실행 파일 갱신 |
-| `node bin/cli.mjs share add skills` | 개인 스킬을 모든 프로필이 같이 씀 |
-| `node bin/cli.mjs mcp list` | 과거 MCP 이름과 전환 안내 조회 |
-| `node bin/cli.mjs rename --help` | 파일 변경 없이 해당 명령의 도움말 확인 |
-
-이관은 원본을 보존하며 데이터가 충돌하면 멈춥니다. 스킬·에이전트·규칙·훅·`CLAUDE.md`는 선택한 프로필에 보존됩니다. macOS Keychain 인증은 복사하지 않아 새 프로필에서 로그인할 수 있습니다. [이관·호환 안내](https://ftery0.github.io/ai-profile-switch/ko/guide/commands)를 참고하세요.
-
-2 버전부터 별도 MCP 편집기와 Claude 설치 관리를 없앴습니다. 공식 `claude mcp`와 Claude의 [업데이트 방식](https://code.claude.com/docs/en/setup#update-manually)을 사용합니다. 과거 MCP 파일은 그대로 보존하며 자동 업데이트는 이 도구만 대상으로 하며 Claude Code는 갱신하지 않습니다.
-
-플랫폼 가이드: [macOS](docs/setup-macos.ko.md) · [Linux](docs/setup-linux.ko.md) · [Windows](docs/setup-windows.ko.md)
+버그 신고, 수정, 문서, 다른 AI 코딩 CLI 지원 모두 환영합니다. [CONTRIBUTING.md](CONTRIBUTING.md)(영어)를 먼저 읽고, [good first issue](https://github.com/ftery0/ai-profile-switch/labels/good%20first%20issue) 나 [new tool](https://github.com/ftery0/ai-profile-switch/labels/new%20tool) 라벨이 붙은 이슈에서 골라 주세요. 이슈와 PR 은 영어로 씁니다. 보안 문제는 공개 이슈 대신 [SECURITY.md](SECURITY.md) 에 적힌 대로 알려 주세요.
 
 [MIT](./LICENSE)

package/README.md

@@ -1,162 +1,97 @@
 # ai-profile-switch
 
 [![npm version](https://img.shields.io/npm/v/ai-profile-switch)](https://www.npmjs.com/package/ai-profile-switch)
-[![license](https://img.shields.io/npm/l/ai-profile-switch)](./LICENSE)
+[![license](https://img.shields.io/github/license/ftery0/ai-profile-switch)](./LICENSE)
 
-Profile switching for [Claude Code](https://code.claude.com/docs/en/iam#log-in-with-multiple-accounts) using `CLAUDE_CONFIG_DIR`. No runtime dependencies.
+Keep several Claude Code accounts on one machine, such as work and personal, and pick one each time you run `claude`. Each profile has its own sign-in, history, and settings. You share only what you choose. No runtime dependencies.
 
 [한국어](./README.ko.md) · [Full guide](https://ftery0.github.io/ai-profile-switch/guide/)
 
-Formerly `claude-account-switch`. Installed shells move to this name on their next automatic update, and `claude-account-switch` remains an alias of the same command. See [existing users](#existing-users).
+![Run claude and pick a profile, switch with cpf, and share CLAUDE.md with cpf share](https://raw.githubusercontent.com/ftery0/ai-profile-switch/main/docs/assets/demo.gif)
 
-## Start
+Formerly `claude-account-switch`. See [existing users](#existing-users).
 
-Use Node.js 18.19+ (18.x) or 20.10+ and your existing Claude Code installation. If Claude Code is missing, follow its [official installation guide](https://code.claude.com/docs/en/setup).
+## Install
+
+You need Node.js 18.19+ or 20.10+ and [Claude Code](https://code.claude.com/docs/en/setup).
 
 ```bash
 npx ai-profile-switch@latest init
 ```
 
-Choose profile names (for example, `work` and `personal`), optionally copy one existing configuration, then open a new terminal. `init` is first-time setup; running it again only shows your existing setup.
-
-## Two commands for everyday use
+Type profile names such as `work, personal`, then open a new terminal.
 
-Run `cpf` and `claude` at your **terminal's shell prompt** (`%` or `$`). If you are inside Claude's chat, enter `/exit` there first and wait for the terminal prompt.
+## Everyday use
 
-1. At the terminal, run `cpf` to open the list, switch, add, rename, remove, or exit menu.
-2. Choose with ↑/↓ and Enter. When finished, select Exit to return to the terminal without launching Claude.
-3. At the terminal, run `claude`, choose a profile, and sign in if Claude asks.
-
-For a direct action, use:
+Run these at the terminal prompt. If you are in the Claude chat, enter `/exit` first.
 
 | Command | What it does |
 | --- | --- |
-| `cpf work` | Make `work` active |
+| `claude` | Pick an account and start Claude Code with it |
+| `cpf` | Open a menu to switch or add profiles. **Manage profiles** shows each one's sign-in and usage, and renames, re-signs, or deletes it |
+| `cpf work` | Make `work` active without starting Claude |
 | `cpf --list` | Show profiles and the active one |
-| `cpf add work2` | Create a profile named `work2` |
-| `cpf rename wrok2 work2` | Rename `wrok2` to `work2` |
-| `cpf remove work2` | Delete `work2` after confirmation |
-| `cpf --help` | Show the command guide |
-
-Replace the example names with yours. A single name always selects that profile, even `cpf add`, `cpf rename`, `cpf remove`, or `cpf list`; use `cpf --list` to list profiles.
-
-With multiple profiles, interactive `claude` launches show a picker, starting on the active profile. In scripts, `claude` uses the active profile without a picker. Claude arguments, including `--help` and `--version`, pass through. Switching affects future launches; already running Claude sessions keep their profile and account.
-
-## Add another account
-
-1. At the terminal, create the profile:
-
-   ```bash
-   cpf add work2
-   ```
-
-2. Start Claude from the terminal:
-
-   ```bash
-   claude
-   ```
-
-3. Select `work2` in the picker, then sign in to the intended account when Claude asks.
-
-Creating a profile does not switch to it or sign in for you. The `cpf` menu can also add a profile without memorizing the command.
-
-## Bring in your existing default account
-
-To run the original Claude CLI without importing a profile, use `command claude` at a Bash/zsh terminal prompt to bypass the wrapper. It uses Claude's normal configuration; if you have set `CLAUDE_CONFIG_DIR` separately, that path applies.
+| `cpf add work2` | Create a profile. Then run `claude`, pick it, and sign in |
+| `cpf rename wrok2 work2` | Rename a profile. Close its Claude sessions first |
+| `cpf remove work2` | Delete a profile after confirmation |
+| `cpf login work2` | Sign `work2` in to another Claude account. Other profiles keep theirs |
+| `cpf language ko` | Show screens in Korean. `en` for English, `auto` to follow the system |
 
-Your normal `~/.claude` configuration is not automatically imported or logged in when you create a profile. First-time `init` lets you select that source and the destination profile. If profiles already exist, rerunning `init` only shows a summary; use an explicit migration instead.
+- The `claude` picker shows each profile's email, plan, and the 5-hour and weekly usage Claude Code last saved. Press a number to pick at once, or Esc to cancel.
+- Screens appear in Korean or English, following your terminal language (`LANG`) or system language.
+- Switching applies to the next launch. Running sessions keep their account.
+- In scripts, `claude` uses the active profile without asking.
+- At a Bash or zsh prompt, `command claude` runs the original Claude without a profile.
+- IDE extensions (VS Code, JetBrains) and the desktop app don't go through the shell, so they keep using the default `~/.claude`.
 
-1. Enter `/exit` in every Claude session using the source or destination, then return to the terminal.
-2. Choose a destination with `cpf --list`. If you need a new profile, create it with `cpf add work`.
-3. From this repository's root in the terminal, copy into that profile and confirm the prompt:
+## Share settings across profiles
 
-   ```bash
-   node bin/cli.mjs migrate work --from ~/.claude
-   ```
-
-4. At the terminal, run `claude`, select `work`, and sign in if requested. Replace `work` with your chosen profile name.
-
-The original `~/.claude` and `~/.claude.json` are preserved. If existing destination data is replaced, its previous copy is also retained at the backup path printed after success. Conflicting data or detected destination changes stop migration. macOS Keychain credentials are not copied, so importing configuration does not guarantee an authenticated session. See [migration details](https://ftery0.github.io/ai-profile-switch/guide/commands#import-an-existing-configuration).
-
-## Fix a profile name
-
-Close every Claude session using the profile before renaming it. For example, to correct `wrok2`:
+Only `settings.json` and `commands` are shared at first.
 
 ```bash
-cpf rename wrok2 work2
+cpf share                 # What is shared, and whether each profile is in sync
+cpf share add CLAUDE.md   # Use one CLAUDE.md in every profile
+cpf share add skills      # Share personal skills
+cpf share remove skills   # Stop sharing. Each profile keeps a copy
 ```
 
-Renaming preserves the profile's history, settings, list position, and active selection. It stops if `work2` already exists. The configuration path changes, so macOS may ask you to sign in again. Start a new Claude session after renaming.
+- Shareable: `CLAUDE.md` `keybindings.json` `skills` `agents` `rules` `hooks` `output-styles` `workflows` `themes`
+- Always per profile: sign-in, `.claude.json` (MCP servers, project trust), history, `projects`, plugins
+- A profile file with different content is never overwritten. You get a warning instead.
 
-## Shared and per-profile items
+## Bring in your existing account
 
-By default only `settings.json` and `commands` are shared. Everything else belongs to one profile. Add what you want every profile to use with `cpf share add`.
+On first setup, `init` can copy your current `~/.claude` into a profile. To do it later, close your Claude sessions and run:
 
 ```bash
-cpf share                  # Show what is shared and whether each profile is in sync
-cpf share add CLAUDE.md    # Share the active profile's CLAUDE.md with every profile
-cpf share add skills       # Share personal skills, linked one by one
-cpf share remove skills    # Stop sharing; each profile keeps a copy
-cpf share sync             # Link items you just added to _shared
+npx ai-profile-switch@latest migrate work --from ~/.claude
 ```
 
-| Can be shared | Always per profile |
-| --- | --- |
-| `CLAUDE.md` `keybindings.json` `skills` `agents` `rules` `hooks` `output-styles` `workflows` `themes` | Sign-in and `.claude.json` (MCP servers, project trust), history, `projects`, plugins, `skills/synced` (skills from the account) |
-
-- The shared copy lives in `~/.claude-profiles/_shared/<entry>` and each profile gets a link. `_shared/CLAUDE.md` may itself link to another file.
-- The first `add` copies the active profile's content when `_shared` has none.
-- Links are refreshed when `claude` launches a profile and when a profile is created. A profile file with different content is never replaced; you get a warning. Move or delete it, then run `cpf share sync`.
-- Settings such as `skillOverrides` and `enabledMcpjsonServers` apply to every profile when placed in the shared `settings.json`. Register MCP servers and sign in per profile with `claude mcp add` and `/mcp`.
+The original folder stays as it is. macOS Keychain sign-ins are not copied, so Claude may ask you to sign in once.
 
-## Existing users
+## Updates
 
-To use changes from this source checkout, run this **from the repository root**, then open a new terminal:
+The shell checks for updates once a day and uses the new version from the next launch. Running sessions are not affected.
 
 ```bash
-node bin/cli.mjs install-shell
+npx ai-profile-switch@latest update          # Update now. Add --check to only check
+npx ai-profile-switch@latest install-shell   # Repair or refresh the shell commands
 ```
 
-For the published npm version, use this to install, repair, or refresh the shell commands and local runtime, then open a new terminal:
+Set `CLAUDE_SWITCH_DISABLE_AUTO_UPDATE=1` to turn automatic updates off.
 
-```bash
-npx ai-profile-switch@latest install-shell
-```
-
-`install-shell` does not add profiles or sign in. Existing shells need the refresh before their `cpf` function can use the new management commands. Users of 1.x also run `install-shell` once to enable the local runtime. The older `claude-pick` command remains available for selecting an active profile without launching Claude.
-
-The shell uses `~/.claude-profiles/_runtime`, so a global installation and the temporary npx cache are not needed for daily use. Node.js, npm, and Claude Code must remain available.
+## Existing users
 
-Interactive Claude launches check for this tool's updates once daily in the background. A verified compatible package becomes active on the next launch. Active sessions keep their existing files; account data, harness hooks, and shell profiles are not rewritten. Offline or failed downloads keep the installed version. Noninteractive launches do not update.
+Coming from `claude-account-switch` or 1.x? Run `npx ai-profile-switch@latest install-shell` once, then open a new terminal. Your profiles and sign-ins stay, and `claude-account-switch` remains an alias.
 
-Set `CLAUDE_SWITCH_DISABLE_AUTO_UPDATE=1` to disable automatic updates. For an immediate update to the published version, run `npx ai-profile-switch@latest update`; add `--check` to check without installing. Global npm installations are independent; the shell runtime updates itself. Previous runtime versions are retained to protect active sessions.
+## More
 
-## Full CLI reference
+- [Command reference and migration details](https://ftery0.github.io/ai-profile-switch/guide/commands)
+- Platform guides: [macOS](docs/setup-macos.md) · [Linux](docs/setup-linux.md) · [Windows](docs/setup-windows.md)
+- To use this source checkout, run `node bin/cli.mjs install-shell` from the repository root.
 
-These commands run the source checkout from the repository root. For a released version, replace `node bin/cli.mjs` with `npx ai-profile-switch@latest`, or `ai-profile-switch` if globally installed.
+## Contributing
 
-| Command | Purpose |
-| --- | --- |
-| `node bin/cli.mjs manage` | Open the same menu as `cpf` |
-| `node bin/cli.mjs manage --list` | List profiles through the management interface |
-| `node bin/cli.mjs init` | First setup or existing setup summary |
-| `node bin/cli.mjs add work2` | Create a profile |
-| `node bin/cli.mjs rename wrok2 work2` | Rename a profile |
-| `node bin/cli.mjs remove work2` | Delete a profile after confirmation |
-| `node bin/cli.mjs list` | Show profiles and active selection |
-| `node bin/cli.mjs use work` | Change the active profile |
-| `node bin/cli.mjs migrate work --from ~/.claude` | Copy existing configuration safely |
-| `node bin/cli.mjs install-shell` | Install, repair, or refresh the local runtime and shell commands |
-| `node bin/cli.mjs update --check` | Check for a published update without installing |
-| `node bin/cli.mjs update` | Update the local runtime |
-| `node bin/cli.mjs share add skills` | Share personal skills with every profile |
-| `node bin/cli.mjs mcp list` | Read legacy MCP names and migration guidance |
-| `node bin/cli.mjs rename --help` | Show help for a command without changing files |
-
-Migration preserves the source and stops on conflicting data. Skills, agents, rules, hooks, and `CLAUDE.md` stay with the selected profile. macOS Keychain credentials are not copied; Claude may require login in the new profile. See [migration and compatibility](https://ftery0.github.io/ai-profile-switch/guide/commands).
-
-Version 2 removes the separate MCP editor and Claude installer. Use official `claude mcp` and Claude's [update mechanism](https://code.claude.com/docs/en/setup#update-manually). Existing legacy MCP files remain unchanged. Automatic updates affect only this tool, never Claude Code.
-
-Platform guides: [macOS](docs/setup-macos.md) · [Linux](docs/setup-linux.md) · [Windows](docs/setup-windows.md)
+Bug reports, fixes, docs, and support for more AI coding CLIs are all welcome. Start with [CONTRIBUTING.md](CONTRIBUTING.md), then pick an issue labeled [good first issue](https://github.com/ftery0/ai-profile-switch/labels/good%20first%20issue) or [new tool](https://github.com/ftery0/ai-profile-switch/labels/new%20tool). Please report security problems privately, as described in [SECURITY.md](SECURITY.md).
 
 [MIT](./LICENSE)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-profile-switch",
-  "version": "2.2.0",
+  "version": "2.2.2",
   "description": "Profile switching for AI coding CLIs, starting with Claude Code (formerly claude-account-switch)",
   "type": "module",
   "bin": {
@@ -16,6 +16,7 @@
   },
   "scripts": {
     "test": "node --test",
+    "test:e2e": "bash test/e2e/single-user/run.sh",
     "docs:dev": "vitepress dev website",
     "docs:build": "vitepress build website",
     "docs:preview": "vitepress preview website"
@@ -34,6 +35,10 @@
     "type": "git",
     "url": "git+https://github.com/ftery0/ai-profile-switch.git"
   },
+  "bugs": {
+    "url": "https://github.com/ftery0/ai-profile-switch/issues"
+  },
+  "homepage": "https://ftery0.github.io/ai-profile-switch/",
   "devDependencies": {
     "vitepress": "^1.6.4"
   },

package/src/commands/add.mjs

@@ -1,19 +1,32 @@
-import { color, success } from '../lib/ui.mjs';
+import { color, success, userError } from '../lib/ui.mjs';
 import { createProfile, validateProfileName, profileExists } from '../lib/profile.mjs';
 import { readMeta } from '../lib/config.mjs';
 import { syncShared } from '../lib/shared.mjs';
+import { t } from '../lib/i18n.mjs';
 import { reportConflicts } from './share.mjs';
 
+// "My Work" → "my-work", offered when a typed name is not allowed.
+function suggestName(name) {
+  return name.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
+}
+
 export async function add(name) {
   const err = validateProfileName(name);
-  if (err) throw new Error(err);
+  if (err) {
+    const suggestion = name ? suggestName(name) : '';
+    throw userError(err, suggestion && suggestion !== name && !validateProfileName(suggestion)
+      ? [{ label: t('hint.try'), command: `cpf add ${suggestion}` }] : []);
+  }
   const meta = readMeta();
   if (profileExists(name) || meta.profiles.includes(name)) {
-    throw new Error(`Profile "${name}" already exists`);
+    throw new Error(t('profile.exists', { name }));
   }
   createProfile(name, meta.shareSettings !== false);
   reportConflicts(syncShared([name]));
-  success(`Created profile: ${name}`);
-  console.log(`  Run ${color.cyan('claude')}, choose ${color.cyan(name)}, and sign in to the intended account.`);
-  console.log(`  To switch without launching: ${color.cyan(`cpf ${name}`)}`);
+  success(t('add.created', { name }));
+  console.log();
+  console.log(`    ${color.dim(t('add.next'))}`);
+  console.log(`    1. ${t('add.step1', { command: color.cyan('claude') })}`);
+  console.log(`    2. ${t('add.step2', { name: color.bold(name) })}`);
+  console.log(`    3. ${t('add.step3')}`);
 }