Skip to content

Commit cefdb48

Browse files
committed
docs: stop hardcoding the pythontemplate workspace name
The claude-code README and TROUBLESHOOTING spelled out `pythontemplate` as the workspace name in ten places -- `devpod ssh pythontemplate` and `/workspaces/pythontemplate` inside the .claude.json examples. That name is right in this repo and wrong in every copy of this tree, and the whole .devcontainer/ directory is about to be copied verbatim into 26 other repositories where no such workspace or ssh host exists. scripts/rename_project.sh cannot rescue those copies: it seds the string `python_template`, which never matches `pythontemplate`. blooop/bencher shows the failure mode already -- its pyproject.toml still runs `ssh pythontemplate.devpod` in a repo called bencher. Shelling into the container now points at `pixi run dev`, which brings the workspace up and sshes in using whatever name the repo actually has. The .claude.json paths, where no task can stand in, use a `<workspace>` placeholder plus a note that `devpod list` shows the real name (`dl --ls` for workspaces devlaunch created).
1 parent cbff39a commit cefdb48

2 files changed

Lines changed: 13 additions & 11 deletions

File tree

‎.devcontainer/claude-code/README.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -228,8 +228,8 @@ This happens because Claude tracks setup completion **per-workspace**, not globa
228228
**Quick fix:**
229229
```bash
230230
# On your HOST machine:
231-
# Set the onboarding flag for your workspace
232-
jq '.projects["/workspaces/pythontemplate"].projectOnboardingSeenCount = 1' ~/.claude/.claude.json > ~/.claude/.claude.json.tmp
231+
# Set the onboarding flag for your workspace (`devpod list` shows its name)
232+
jq '.projects["/workspaces/<workspace>"].projectOnboardingSeenCount = 1' ~/.claude/.claude.json > ~/.claude/.claude.json.tmp
233233
mv ~/.claude/.claude.json.tmp ~/.claude/.claude.json
234234

235235
# Also ensure themeMode is set (if needed)
@@ -239,9 +239,9 @@ mv ~/.claude/.claude.json.tmp ~/.claude/.claude.json
239239
# Then restart `claude` in the container -- the mount is live, so no rebuild is needed
240240
```
241241

242-
**Root cause:** Claude tracks setup wizard completion per-workspace in `.claude.json` under `.projects["/workspaces/pythontemplate"].projectOnboardingSeenCount`. When this is `0`, the setup wizard runs. Set it to `1` to mark setup as complete.
242+
**Root cause:** Claude tracks setup wizard completion per-workspace in `.claude.json` under `.projects["/workspaces/<workspace>"].projectOnboardingSeenCount`. When this is `0`, the setup wizard runs. Set it to `1` to mark setup as complete.
243243

244-
**For future workspaces:** Replace `/workspaces/pythontemplate` with your actual container workspace path.
244+
**Finding `<workspace>`:** it is the devpod workspace name, and the container mounts the repo at `/workspaces/<workspace>`. `devpod list` shows the name, and `dl --ls` shows it for workspaces devlaunch created.
245245

246246
## Modifying Configuration
247247

‎.devcontainer/claude-code/TROUBLESHOOTING.md‎

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -52,17 +52,19 @@ Claude tracks setup completion per-workspace in `.claude.json`:
5252
```json
5353
{
5454
"projects": {
55-
"/workspaces/pythontemplate": {
55+
"/workspaces/<workspace>": {
5656
"projectOnboardingSeenCount": 0 // ← This!
5757
}
5858
}
5959
}
6060
```
6161

62+
`<workspace>` is the devpod workspace name -- `devpod list` shows it, and `dl --ls` shows it for workspaces devlaunch created.
63+
6264
**Solution:**
6365
```bash
6466
# On HOST machine, set a high count to skip wizard
65-
jq '.projects["/workspaces/pythontemplate"].projectOnboardingSeenCount = 999' \
67+
jq '.projects["/workspaces/<workspace>"].projectOnboardingSeenCount = 999' \
6668
~/.claude/.claude.json > ~/.claude/.claude.json.tmp
6769
mv ~/.claude/.claude.json.tmp ~/.claude/.claude.json
6870

@@ -77,8 +79,8 @@ mv ~/.claude/.claude.json.tmp ~/.claude/.claude.json
7779

7880
**Verification:**
7981
```bash
80-
# In container
81-
devpod ssh pythontemplate
82+
# From the host, shell into the container
83+
pixi run dev
8284
claude # Should go straight to interactive mode without wizard
8385
```
8486

@@ -138,7 +140,7 @@ Two different issues:
138140

139141
1. **Verify the mount in the container:**
140142
```bash
141-
devpod ssh pythontemplate
143+
pixi run dev
142144
mount | grep claude
143145
```
144146

@@ -232,7 +234,7 @@ echo "what is 2+2" | claude --print
232234

233235
```bash
234236
# On HOST
235-
cat ~/.claude/.claude.json | jq '.projects["/workspaces/pythontemplate"]'
237+
cat ~/.claude/.claude.json | jq '.projects["/workspaces/<workspace>"]'
236238
```
237239

238240
Look for:
@@ -286,7 +288,7 @@ Contains account info, feature flags, and per-workspace state. Key fields:
286288
"userID": "...",
287289
"themeMode": "dark",
288290
"projects": {
289-
"/workspaces/pythontemplate": {
291+
"/workspaces/<workspace>": {
290292
"projectOnboardingSeenCount": 999,
291293
"hasTrustDialogAccepted": false,
292294
...

0 commit comments

Comments
 (0)