Skip to content

feat(devcontainer): add volume mounts for persistent storage#5746

Open
Githubguy132010 wants to merge 4 commits intoKilo-Org:mainfrom
Githubguy132010:devcontainer-storage-persistence-and-docs
Open

feat(devcontainer): add volume mounts for persistent storage#5746
Githubguy132010 wants to merge 4 commits intoKilo-Org:mainfrom
Githubguy132010:devcontainer-storage-persistence-and-docs

Conversation

@Githubguy132010
Copy link
Contributor

@Githubguy132010 Githubguy132010 commented Feb 7, 2026

Context

This PR adds dev container persistence support for Kilo Code, ensuring that threads, settings, and caches are preserved across container rebuilds. The changes configure named Docker volumes to persist important data that would otherwise be lost when the dev container is rebuilt.

Implementation

The implementation involves three changes:

  1. .devcontainer/devcontainer.json: Added named volume mounts for persisting Kilo Code state:

    • kilocode-global-storage: Persists threads, cache, and vector store data at /root/.vscode-remote/data/User/globalStorage/kilocode.kilo-code
    • kilocode-settings: Persists VS Code settings at /root/.vscode-remote/data/User/settings
  2. .devcontainer/README.md: Added comprehensive documentation explaining:

    • What data is persisted and where it's stored
    • How named volumes preserve data across rebuilds
    • Troubleshooting steps for thread recovery
    • Backup procedures
    • Custom storage path configuration
  3. apps/kilocode-docs/docs/getting-started/devcontainer-persistence.md: Added user-facing documentation covering:

    • Why persistence matters for dev containers
    • Required configuration for custom dev containers
    • Storage location reference table
    • Troubleshooting common issues
    • Custom storage path setup
    • Best practices and GitHub Codespaces guidance

Tradeoffs

  • Named volumes are Docker-specific but work across all Docker-based dev container environments
  • Volume mount paths use root user paths, consistent with the container's remoteUser configuration
  • Documentation is split between the .devcontainer folder (for contributors) and the user docs (for end users)

Screenshots

N/A

How to Test

  1. Open the project in a dev container using VS Code
  2. Create some threads with Kilo Code (start a conversation, complete a task)
  3. Rebuild the dev container using "Dev Containers: Rebuild Container" command
  4. Reopen the project in the dev container
  5. Verify that your threads are still present in the Kilo Code sidebar

Alternatively, check that the named volumes exist:

docker volume ls | grep kilocode

Get in Touch

thomas07374

Fixes #691

Configure devcontainer to persist VS Code settings and Kilo Code state across container rebuilds by adding dedicated volume mounts for:
- Global storage (threads, caches, extensions)
- User settings

Also added workspaceMount and workspaceFolder configuration for better workspace management.

Includes documentation for devcontainer persistence setup.
@changeset-bot
Copy link

changeset-bot bot commented Feb 7, 2026

🦋 Changeset detected

Latest commit: ddc179a

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package
Name Type
kilo-code Patch

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

Copy link

@chatgpt-codex-connector chatgpt-codex-connector bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 6179524650

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

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.

Document dev container persistence requirements for Kilo threads

1 participant