Skip to content

docs(kilo-docs): add workspace migration section to KiloClaw FAQ#8287

Open
kilo-code-bot[bot] wants to merge 2 commits intomainfrom
docs/kiloclaw-workspace-migration
Open

docs(kilo-docs): add workspace migration section to KiloClaw FAQ#8287
kilo-code-bot[bot] wants to merge 2 commits intomainfrom
docs/kiloclaw-workspace-migration

Conversation

@kilo-code-bot
Copy link
Copy Markdown
Contributor

@kilo-code-bot kilo-code-bot bot commented Apr 3, 2026

Summary

  • Moves the "Migrating Your Workspace" section from the KiloClaw Dashboard page (dashboard.md) to the FAQ page (faq/general.md) where it is a better fit
  • Reverts dashboard.md to its original state (no migration content)
  • Expands the migration documentation with:
    • Clear breakdown of what migrates (workspace files, memory, context) vs. what doesn't (integrations/tokens)
    • Two backup options: GitHub and Google Drive (manual export)
    • Step-by-step restore instructions for each backup method
    • Detailed integration reconfiguration checklist (Google, GitHub, GitLab, Linear, Telegram, Discord, Slack)
    • Note about workspace memory and context carrying over automatically

Built for Alex Gold by Kilo for Slack

@vercel
Copy link
Copy Markdown

vercel bot commented Apr 3, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs (docs-staging) Ready Ready Preview, Comment Apr 3, 2026 4:26pm

Request Review


Ask your Claw to push the workspace to a GitHub repository:

> Create a new GitHub repo and push your entire workspace there with the `gh` CLI. Tell me the URL of the repo you used.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

WARNING: GitHub repo backup can produce incomplete restores

Pushing the entire workspace into a new GitHub repository does not faithfully preserve common /root/clawd layouts. Nested project repositories are typically recorded as gitlinks instead of full contents, and anything not committed into the temporary backup repo is dropped on restore. That makes this migration path prone to silent data loss unless it is limited to non-nested workspaces or changed to use an archive-based backup.

@kilo-code-bot
Copy link
Copy Markdown
Contributor Author

kilo-code-bot bot commented Apr 3, 2026

Code Review Summary

Status: 1 Issues Found | Recommendation: Address before merge

Overview

Severity Count
CRITICAL 0
WARNING 1
SUGGESTION 0
Issue Details (click to expand)

WARNING

File Line Issue
packages/kilo-docs/pages/kiloclaw/faq/general.md 50 GitHub repo backup can silently lose nested repository contents and git metadata during restore.
Other Observations (not in diff)

No additional issues found outside the diff.

Files Reviewed (2 files)
  • packages/kilo-docs/pages/kiloclaw/dashboard.md
  • packages/kilo-docs/pages/kiloclaw/faq/general.md - 1 issue

Fix these issues in Kilo Cloud


Reviewed by gpt-5.4-20260305 · 137,758 tokens

…AQ page

Move the 'Migrating Your Workspace' content from dashboard.md to
faq/general.md where it better fits as a frequently asked question.
The FAQ version is expanded with a clear what-migrates/what-doesn't
breakdown, workspace memory/context note, and step-by-step
integration reconfiguration instructions.
@kilo-code-bot kilo-code-bot bot changed the title docs(kilo-docs): add workspace migration section to KiloClaw dashboard docs(kilo-docs): add workspace migration section to KiloClaw FAQ Apr 3, 2026

Ask your Claw to push the workspace to a GitHub repository:

> Create a new GitHub repo and push your entire workspace there with the `gh` CLI. Tell me the URL of the repo you used.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

WARNING: GitHub repo backup can drop embedded repositories

Pushing the whole workspace into a new GitHub repository will not round-trip common /root/clawd layouts. Embedded project repos are typically stored as gitlinks instead of full working trees, so restoring from that backup can silently lose nested repo contents and git metadata unless this step is changed to archive the workspace first.

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.

0 participants