agent-teleport
by lilyjazz
Notes & PKMBrief
Seamlessly migrate your agent's configuration and memory to a new machine using TiDB Zero.
Description
What This Skill Does
Migrates an AI agent's full state, including memory, configuration, and workspace files, from one machine to another. Uses TiDB as the transfer medium, either via user-provided credentials or an auto-provisioned temporary cluster. Generates a restore code on the source machine and applies it on the destination.
Avoids manually reconstructing agent memory and config by serializing the full state into a portable restore code.
When to Use It
- Moving active agent session from office desktop to home laptop
- Creating a snapshot before running a destructive or experimental task
- Duplicating agent configuration to a second machine
- Recovering agent state after a hardware failure
- Cloning a configured agent to a colleague's machine
Example Workflow
User asks: teleport my agent to my laptop
- 1
Reads current agent memory, configuration, and workspace files
- 2
Connects to TiDB using provided credentials or provisions a temporary serverless cluster
- 3
Serializes and uploads the full agent state to the database
- 4
Returns a DSN or short restore code to the user
- 5
User runs the restore command on the destination machine with the provided code
Agent state fully restored on the destination machine, ready to continue where it left off
Requirements
- TiDB Cloud account
- TIDB_HOST environment variable
- TIDB_PORT environment variable
- TIDB_USER environment variable
- TIDB_PASSWORD environment variable
Installation
clawhub install lilyjazz/agent-teleportRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.