T
thomasog/coldstart
Agent skill that gets any folder ready for AI agents, once: AGENTS.md, handoff and memory in plain files
View on GitHub ↗Link checked 2026-11-12 · HTTP 200 · opens the vendor's own site
Install & config
Client config (built from the install command this repo gives)
{
"mcpServers": {
"thomasog-coldstart": {
"command": "npx",
"args": ["skills"]
}
}
}Parsed from the README we fetched on 2026-11-04; we have not executed it.
command/args come from the install command the repository states. When it is ambiguous, the project README wins.
VS Code (.vscode/mcp.json - the key is servers)
{
"servers": {
"thomasog-coldstart": {
"command": "npx",
"args": ["skills"]
}
}
}Same server, but VS Code keeps it under <code>servers</code>.
Claude Code (command line)
claude mcp add --transport stdio thomasog-coldstart -- npx skills
Claude Code does not read a config file; add the server with this command.
Key names differ by client: Clients & CLI
- Star count
- 0 ★ · thomasog/coldstart · read from the GitHub search API · (checked 2026-11-13 20:00:50)
- Source
- read directly from its GitHub page · type: open-source project
- Harvest history
- first seen 2026-11-05 · last seen 2026-11-14 · seen 10× · listed by 1 sources
- Score
- score 103 · 1 sources · repo
- Install
npx skills
FAQ (answers come from our records)
How do I install it?
The repository provides this install command:
npx skills. It comes from the repository itself; we cannot guarantee it runs as-is in your client.Who is it for?
We filed it under these tags: Agent 技能. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
repository
thomasog/coldstart；first catalogued 2026-11-05；last seen 2026-11-14。There is no official certification or quality rating here — we record sources and dates only.# coldstart
以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →
Get any folder ready for AI agents, once.
The next agent picks up where the last one stopped, on any machine.
An illustration of a typical run, not a screen recording.
## Why
No lock-in. Your instructions and memory don't belong to one agent. Switch agents and keep working.
It all lives in the folder. Nothing important is trapped in an account or in an app's hidden data.
It travels. Copy, sync or zip the folder, and the context goes with it.
It lasts. Plain text you can still read years from now, with no special tool.
## What it does
Run coldstart in a code repo or in a personal project such as a move, a trip or paperwork. It lists the folder, asks a few questions, writes the files below, and stops. It doesn't open your documents or start the project's work; that belongs to the next session.
├── AGENTS.md # instructions any agent can read
├── .ai/
│ ├── HANDOFF.md # where we stopped and what comes next
│ └── memory/
│ └── MEMORY.md # index of durable facts
├── .gitignore # only if you want git
└── .claude/ # only if you use Claude Code
├── CLAUDE.md # imports AGENTS.md, the handoff and the memory index
├── settings.json # keeps plans and memory inside the folder
└── agents/
├── scout.md # fast and cheap: search, read, bulk vision
└── advisor.md # strong second opinion for hard calls
The habit that makes it work: agents read .ai/HANDOFF.md at the start of a session and rewrite it at the end.
## Works with
| Agent | Status |
| Claude Code | Tested |
| Codex | Tested |
| Cursor, Copilot, Antigravity | Read AGENTS.md according to their documentation; not yet run |
## Install
Paste this into your agent:
text
Install the agent skill in skills/coldstart from https://github.com/thomasog/coldstart, then tell me how to run it.
Or use a command:
bash
npx skills add thomasog/coldstart
bash
gh skill install thomasog/coldstart coldstart --agent codex --scope user
Claude Code plugin:
bash
claude plugin marketplace add thomasog/coldstart
bash
claude plugin install coldstart@thomasog-plugins
By hand: copy skills/coldstart/ to ~/.agents/skills/, or to ~/.claude/skills/ for Claude Code.
## Use
Ask for it by name: /coldstart in Claude Code, $coldstart in Codex, or "run coldstart" anywhere. It never starts on its own. If the folder has no git, start your agent from the folder itself.
## What it reads, writes and runs
Reads: file names, agent instruction files such as CLAUDE.md, and project manifests such as package.json. Nothing outside the folder.
Writes: the files above, and nothing else. It moves old instruction files to .ai/scratch/ instead of deleting them, and shows you any command, URL or install step they contain first.
Runs: skills/coldstart/scripts/coldstart.py, a short Python script that uses only the standard library, makes no network calls and asks no questions. Without Python, the agent does the same steps by hand.
Changes in Claude Code: .claude/settings.json turns off auto memory for that folder, so memory stays in .ai/memory/. Anything Claude had already saved for the folder stays in ~/.claude and is no longer loaded there; copy what you want by hand. The same file blocks reading .env files.
The next agent picks up where the last one stopped, on any machine.
An illustration of a typical run, not a screen recording.
## Why
No lock-in. Your instructions and memory don't belong to one agent. Switch agents and keep working.
It all lives in the folder. Nothing important is trapped in an account or in an app's hidden data.
It travels. Copy, sync or zip the folder, and the context goes with it.
It lasts. Plain text you can still read years from now, with no special tool.
## What it does
Run coldstart in a code repo or in a personal project such as a move, a trip or paperwork. It lists the folder, asks a few questions, writes the files below, and stops. It doesn't open your documents or start the project's work; that belongs to the next session.
├── AGENTS.md # instructions any agent can read
├── .ai/
│ ├── HANDOFF.md # where we stopped and what comes next
│ └── memory/
│ └── MEMORY.md # index of durable facts
├── .gitignore # only if you want git
└── .claude/ # only if you use Claude Code
├── CLAUDE.md # imports AGENTS.md, the handoff and the memory index
├── settings.json # keeps plans and memory inside the folder
└── agents/
├── scout.md # fast and cheap: search, read, bulk vision
└── advisor.md # strong second opinion for hard calls
The habit that makes it work: agents read .ai/HANDOFF.md at the start of a session and rewrite it at the end.
## Works with
| Agent | Status |
| Claude Code | Tested |
| Codex | Tested |
| Cursor, Copilot, Antigravity | Read AGENTS.md according to their documentation; not yet run |
## Install
Paste this into your agent:
text
Install the agent skill in skills/coldstart from https://github.com/thomasog/coldstart, then tell me how to run it.
Or use a command:
bash
npx skills add thomasog/coldstart
bash
gh skill install thomasog/coldstart coldstart --agent codex --scope user
Claude Code plugin:
bash
claude plugin marketplace add thomasog/coldstart
bash
claude plugin install coldstart@thomasog-plugins
By hand: copy skills/coldstart/ to ~/.agents/skills/, or to ~/.claude/skills/ for Claude Code.
## Use
Ask for it by name: /coldstart in Claude Code, $coldstart in Codex, or "run coldstart" anywhere. It never starts on its own. If the folder has no git, start your agent from the folder itself.
## What it reads, writes and runs
Reads: file names, agent instruction files such as CLAUDE.md, and project manifests such as package.json. Nothing outside the folder.
Writes: the files above, and nothing else. It moves old instruction files to .ai/scratch/ instead of deleting them, and shows you any command, URL or install step they contain first.
Runs: skills/coldstart/scripts/coldstart.py, a short Python script that uses only the standard library, makes no network calls and asks no questions. Without Python, the agent does the same steps by hand.
Changes in Claude Code: .claude/settings.json turns off auto memory for that folder, so memory stays in .ai/memory/. Anything Claude had already saved for the folder stays in ~/.claude and is no longer loaded there; copy what you want by hand. The same file blocks reading .env files.
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/thomasog-coldstart/)
- Source
- github · https://github.com/thomasog/coldstart
- Browse by field
- Agent skills
- added
- today
More like this
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.