Skip to content

feat: seed CLAUDE.md on first start to give remote sessions workspace context - #3

Merged
mashkovd merged 1 commit into
mainfrom
seed-claude-md
May 21, 2026
Merged

mashkovd merged 1 commit into
mainfrom
seed-claude-md

Conversation

@mashkovd

Copy link
Copy Markdown
Member

Summary

  • Seeds /workspace/CLAUDE.md at container startup if one does not already exist
  • Gives Claude context about its environment (remote worker, workspace path, session continuity limitations) on every new remote session
  • Idempotent: never overwrites a user-provided CLAUDE.md on the persistent volume

Background

In --remote-control mode, conversation history is managed by the relay and is not preserved across pod restarts. Session files on disk are cache/metadata only; there is no --resume flag. Without any workspace context file, Claude starts each new session with zero awareness of where it's running or what tools/paths are available.

A seeded CLAUDE.md is the standard Claude Code pattern for this — lightweight and overridable.

Test plan

  • sh -n entrypoint.sh passes
  • docker build succeeds
  • Fresh container: CLAUDE.md is present at /workspace/CLAUDE.md
  • Container with existing /workspace/CLAUDE.md: file is NOT overwritten

🤖 Generated with Claude Code

@mashkovd
mashkovd merged commit 6b23a85 into main May 21, 2026
1 check passed
@mashkovd
mashkovd deleted the seed-claude-md branch May 21, 2026 08:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant