claudectx 0.1.0

Launch Claude Code with different profiles
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265

<div align="center">

# claudectx

**Launch Claude Code with different profiles**

<br/>

<img src="img/demo.svg" alt="claudectx demo" width="700"/>

<br/>
<br/>

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Crates.io](https://img.shields.io/crates/v/claudectx.svg)](https://crates.io/crates/claudectx)
[![CI](https://github.com/FGRibreau/claudectx/workflows/CI/badge.svg)](https://github.com/FGRibreau/claudectx/actions)
[![GitHub release](https://img.shields.io/github/release/FGRibreau/claudectx.svg)](https://github.com/FGRibreau/claudectx/releases)
[![GitHub stars](https://img.shields.io/github/stars/FGRibreau/claudectx.svg)](https://github.com/FGRibreau/claudectx/stargazers)

</div>

---

## What is this?

**claudectx** manages multiple Claude Code profiles (Claude Max, Claude Team, personal) and launches Claude with the selected profile. Each profile is a complete `claude.json` config with its own account, MCP servers, and settings. Inspired by [kubectx](https://github.com/FGRibreau/kubectx-rs).

## How it works

1. **Save**: `claudectx save work` copies `~/.claude.json` to `~/.claudectx/work.claude.json`
2. **Launch**: `claudectx work` switches `~/.claude.json` symlink → profile, then launches `claude`

The symlink ensures Claude reads the correct account configuration.

## Features

- **Profile switching** - Symlink-based switching for proper account isolation
- **Direct launch** - Launches Claude automatically after switching
- **Save profiles** - Store complete Claude configurations locally
- **Quick switch** - Interactive selection with arrow keys
- **Pass-through args** - Forward arguments to Claude: `claudectx work -- --dangerously-skip-permissions`
- **Auto-slugify** - Profile names are normalized (`FG@Work` → `fg-work`)
- **Zero config** - Works out of the box

---

## Sponsors

<table>
  <tr>
    <td align="center" width="200">
        <a href="https://getnatalia.com/">
        <img src="assets/sponsors/natalia.svg" height="60" alt="Natalia"/><br/>
        <b>Natalia</b>
        </a><br/>
        <sub>24/7 AI voice and whatsapp agent for customer services</sub>
    </td>
    <td align="center" width="200">
      <a href="https://nobullshitconseil.com/">
        <img src="assets/sponsors/nobullshitconseil.svg" height="60" alt="NoBullshitConseil"/><br/>
        <b>NoBullshitConseil</b>
      </a><br/>
      <sub>360° tech consulting</sub>
    </td>
    <td align="center" width="200">
      <a href="https://www.hook0.com/">
        <img src="assets/sponsors/hook0.png" height="60" alt="Hook0"/><br/>
        <b>Hook0</b>
      </a><br/>
      <sub>Open-Source Webhooks-as-a-Service</sub>
    </td>
    <td align="center" width="200">
      <a href="https://france-nuage.fr/">
        <img src="assets/sponsors/france-nuage.png" height="60" alt="France-Nuage"/><br/>
        <b>France-Nuage</b>
      </a><br/>
      <sub>Sovereign cloud hosting in France</sub>
    </td>
  </tr>
</table>

> **Interested in sponsoring?** [Get in touch](mailto:sponsoring@fgribreau.com)

---

## Quick Start

```sh
# 1. Install
brew install FGRibreau/tap/claudectx

# 2. Save your current account as a profile
claudectx save work

# 3. Launch Claude with the profile
claudectx work
```

---

## Installation

### macOS

```sh
# Homebrew (recommended)
brew install FGRibreau/tap/claudectx

# or with Cargo
cargo install claudectx
```

### Linux

```sh
# Debian/Ubuntu (.deb)
curl -LO https://github.com/FGRibreau/claudectx/releases/latest/download/claudectx_0.1.0_amd64.deb
sudo dpkg -i claudectx_0.1.0_amd64.deb

# Cargo (all distros)
cargo install claudectx

# or download binary
curl -LO https://github.com/FGRibreau/claudectx/releases/latest/download/claudectx_linux_x86_64.tar.gz
tar -xzf claudectx_linux_x86_64.tar.gz
sudo mv claudectx /usr/local/bin/
```

### Windows

```powershell
# Chocolatey
choco install claudectx

# Scoop
scoop bucket add extras
scoop install claudectx

# or with Cargo
cargo install claudectx
```

### All platforms

| Platform | Method | Command |
|----------|--------|---------|
| macOS | Homebrew | `brew install FGRibreau/tap/claudectx` |
| macOS | Cargo | `cargo install claudectx` |
| Linux | Debian/Ubuntu | `sudo dpkg -i claudectx_*_amd64.deb` |
| Linux | Cargo | `cargo install claudectx` |
| Windows | Chocolatey | `choco install claudectx` |
| Windows | Scoop | `scoop install claudectx` |
| Windows | Cargo | `cargo install claudectx` |
| All | Binary | [Download from Releases](https://github.com/FGRibreau/claudectx/releases) |

<details>
<summary>Available binaries</summary>

| Platform | Architecture | Download |
|----------|--------------|----------|
| Linux | x86_64 | `claudectx_linux_x86_64.tar.gz` |
| Linux | x86_64 (static) | `claudectx_linux_x86_64_musl.tar.gz` |
| Linux | ARM64 | `claudectx_linux_aarch64.tar.gz` |
| Linux | ARM64 (static) | `claudectx_linux_aarch64_musl.tar.gz` |
| Linux | ARMv7 | `claudectx_linux_armv7.tar.gz` |
| Linux | x86_64 (.deb) | `claudectx_*_amd64.deb` |
| Linux | ARM64 (.deb) | `claudectx_*_arm64.deb` |
| macOS | Intel | `claudectx_darwin_x86_64.tar.gz` |
| macOS | Apple Silicon | `claudectx_darwin_aarch64.tar.gz` |
| Windows | x86_64 | `claudectx_windows_x86_64.zip` |

</details>

<details>
<summary>Manual installation from source</summary>

```sh
git clone https://github.com/FGRibreau/claudectx.git
cd claudectx
cargo build --release
sudo cp target/release/claudectx /usr/local/bin/
```

</details>

---

## Usage

| Command | Description |
|---------|-------------|
| `claudectx` | Interactive profile selection, then launch Claude |
| `claudectx <profile>` | Switch to profile and launch Claude |
| `claudectx <profile> -- <args>` | Launch Claude with profile and extra arguments |
| `claudectx list` | List all saved profiles (* marks current) |
| `claudectx save <name>` | Save current config as profile |
| `claudectx delete <name>` | Delete a profile |

### Examples

```sh
# Launch Claude with "work" profile
claudectx work

# Launch with extra arguments
claudectx work -- --dangerously-skip-permissions

# Save current ~/.claude.json as "personal" profile
claudectx save personal

# Interactive selection then launch
claudectx

# List all profiles (* marks current)
claudectx list
# Output:
# work - FG @ Company *
# personal - FG @ Personal
```

---

## Configuration

### Storage

Profiles are stored as individual JSON files in `~/.claudectx/`:

```
~/.claudectx/
├── work.claude.json
├── personal.claude.json
└── side-project.claude.json
```

When you run `claudectx <profile>`:
1. `~/.claude.json` becomes a symlink → `~/.claudectx/<profile>.claude.json`
2. Claude is launched and reads from the symlinked config

Each profile is a complete copy of `~/.claude.json`, including:
- OAuth account (email, organization)
- MCP servers configuration
- Claude Code settings
- API keys

### Profile Names

Profile names are automatically slugified:
- `My Work Profile` → `my-work-profile`
- `FG@Company` → `fg-company`
- `Test Name` → `test-name`

---

## License

[MIT](LICENSE)

---

<div align="center">

**Like claudectx?** Check out [kubectx-rs](https://github.com/FGRibreau/kubectx-rs) for Kubernetes context switching

</div>