Keeps backlog, docs, history and memory as Markdown in the repository, with card claims so parallel agents avoid conflicts.
Setup
Choose your client, copy the config, then fill in any required environment variables.
claude mcp add workfile -- npx -y @illodev/workfile mcp~/.codex/config.toml
[mcp_servers.workfile]
command = "npx"
args = ["-y", "@illodev/workfile", "mcp"]
# codex mcp add workfile -- npx -y @illodev/workfile mcp~/.cursor/mcp.json
{
"mcpServers": {
"workfile": {
"command": "npx",
"args": [
"-y",
"@illodev/workfile",
"mcp"
]
}
}
}.vscode/mcp.json
{
"servers": {
"workfile": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@illodev/workfile",
"mcp"
]
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"workfile": {
"command": "npx",
"args": [
"-y",
"@illodev/workfile",
"mcp"
]
}
}
}claude_desktop_config.json
{
"mcpServers": {
"workfile": {
"command": "npx",
"args": [
"-y",
"@illodev/workfile",
"mcp"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"workfile": {
"command": "npx",
"args": [
"-y",
"@illodev/workfile",
"mcp"
]
}
}
}