From c234f221f9be698bc0501c60459e1ae8e67df6c3 Mon Sep 17 00:00:00 2001 From: Ogulcan Celik Date: Wed, 22 Jul 2026 14:58:26 +0300 Subject: [PATCH] feat(docs): publish versioned release documentation --- .github/workflows/preview.yml | 14 +- .github/workflows/release.yml | 25 +- .github/workflows/website.yml | 47 + .gitignore | 2 + AGENTS.md | 6 +- CONTRIBUTING.md | 2 +- .../website/src/content/docs/agent-skill.mdx | 103 ++ .../website/src/content/docs/agents.mdx | 129 ++ .../src/content/docs/cli-reference.mdx | 192 +++ .../website/src/content/docs/concepts.mdx | 85 ++ .../src/content/docs/configuration.mdx | 244 ++++ .../0.5.11/website/src/content/docs/index.mdx | 104 ++ .../website/src/content/docs/install.mdx | 58 + .../website/src/content/docs/integrations.mdx | 130 ++ .../src/content/docs/persistence-remote.mdx | 125 ++ .../website/src/content/docs/quick-start.mdx | 80 ++ .../website/src/content/docs/socket-api.mdx | 224 ++++ .../website/src/content/docs/agent-skill.mdx | 55 + .../website/src/content/docs/agents.mdx | 129 ++ .../src/content/docs/cli-reference.mdx | 195 +++ .../website/src/content/docs/concepts.mdx | 85 ++ .../src/content/docs/configuration.mdx | 290 +++++ .../website/src/content/docs/how-to-work.mdx | 103 ++ .../0.5.12/website/src/content/docs/index.mdx | 59 + .../website/src/content/docs/install.mdx | 58 + .../website/src/content/docs/integrations.mdx | 136 ++ .../src/content/docs/persistence-remote.mdx | 141 +++ .../website/src/content/docs/quick-start.mdx | 82 ++ .../website/src/content/docs/socket-api.mdx | 224 ++++ .../website/src/content/docs/agent-skill.mdx | 55 + .../0.6.0/website/src/content/docs/agents.mdx | 130 ++ .../src/content/docs/cli-reference.mdx | 195 +++ .../website/src/content/docs/concepts.mdx | 85 ++ .../src/content/docs/configuration.mdx | 309 +++++ .../website/src/content/docs/how-to-work.mdx | 103 ++ .../0.6.0/website/src/content/docs/index.mdx | 59 + .../website/src/content/docs/install.mdx | 58 + .../website/src/content/docs/integrations.mdx | 138 ++ .../src/content/docs/persistence-remote.mdx | 143 +++ .../website/src/content/docs/quick-start.mdx | 84 ++ .../website/src/content/docs/socket-api.mdx | 224 ++++ .../website/src/content/docs/agent-skill.mdx | 55 + .../0.6.1/website/src/content/docs/agents.mdx | 133 ++ .../src/content/docs/cli-reference.mdx | 196 +++ .../website/src/content/docs/concepts.mdx | 85 ++ .../src/content/docs/configuration.mdx | 355 ++++++ .../website/src/content/docs/how-to-work.mdx | 103 ++ .../0.6.1/website/src/content/docs/index.mdx | 59 + .../website/src/content/docs/install.mdx | 58 + .../website/src/content/docs/integrations.mdx | 138 ++ .../src/content/docs/persistence-remote.mdx | 145 +++ .../website/src/content/docs/quick-start.mdx | 84 ++ .../website/src/content/docs/socket-api.mdx | 224 ++++ .../website/src/content/docs/agent-skill.mdx | 55 + .../website/src/content/docs/agents.mdx | 178 +++ .../src/content/docs/cli-reference.mdx | 276 ++++ .../website/src/content/docs/concepts.mdx | 85 ++ .../src/content/docs/configuration.mdx | 489 +++++++ .../website/src/content/docs/how-to-work.mdx | 103 ++ .../0.6.10/website/src/content/docs/index.mdx | 71 ++ .../website/src/content/docs/install.mdx | 151 +++ .../website/src/content/docs/integrations.mdx | 270 ++++ .../src/content/docs/persistence-remote.mdx | 159 +++ .../website/src/content/docs/quick-start.mdx | 92 ++ .../src/content/docs/session-state.mdx | 102 ++ .../website/src/content/docs/socket-api.mdx | 428 +++++++ .../website/src/content/docs/windows-beta.mdx | 97 ++ .../website/src/content/docs/agent-skill.mdx | 55 + .../0.6.2/website/src/content/docs/agents.mdx | 134 ++ .../src/content/docs/cli-reference.mdx | 211 ++++ .../website/src/content/docs/concepts.mdx | 85 ++ .../src/content/docs/configuration.mdx | 364 ++++++ .../website/src/content/docs/how-to-work.mdx | 103 ++ .../0.6.2/website/src/content/docs/index.mdx | 59 + .../website/src/content/docs/install.mdx | 89 ++ .../website/src/content/docs/integrations.mdx | 158 +++ .../src/content/docs/persistence-remote.mdx | 145 +++ .../website/src/content/docs/quick-start.mdx | 84 ++ .../website/src/content/docs/socket-api.mdx | 249 ++++ .../website/src/content/docs/agent-skill.mdx | 55 + .../0.6.3/website/src/content/docs/agents.mdx | 138 ++ .../src/content/docs/cli-reference.mdx | 233 ++++ .../website/src/content/docs/concepts.mdx | 85 ++ .../src/content/docs/configuration.mdx | 418 ++++++ .../website/src/content/docs/how-to-work.mdx | 103 ++ .../0.6.3/website/src/content/docs/index.mdx | 64 + .../website/src/content/docs/install.mdx | 107 ++ .../website/src/content/docs/integrations.mdx | 192 +++ .../src/content/docs/persistence-remote.mdx | 153 +++ .../website/src/content/docs/quick-start.mdx | 86 ++ .../src/content/docs/session-state.mdx | 94 ++ .../website/src/content/docs/socket-api.mdx | 275 ++++ .../website/src/content/docs/agent-skill.mdx | 55 + .../0.6.4/website/src/content/docs/agents.mdx | 138 ++ .../src/content/docs/cli-reference.mdx | 233 ++++ .../website/src/content/docs/concepts.mdx | 85 ++ .../src/content/docs/configuration.mdx | 418 ++++++ .../website/src/content/docs/how-to-work.mdx | 103 ++ .../0.6.4/website/src/content/docs/index.mdx | 64 + .../website/src/content/docs/install.mdx | 107 ++ .../website/src/content/docs/integrations.mdx | 192 +++ .../src/content/docs/persistence-remote.mdx | 153 +++ .../website/src/content/docs/quick-start.mdx | 86 ++ .../src/content/docs/session-state.mdx | 94 ++ .../website/src/content/docs/socket-api.mdx | 275 ++++ .../website/src/content/docs/agent-skill.mdx | 55 + .../0.6.5/website/src/content/docs/agents.mdx | 138 ++ .../src/content/docs/cli-reference.mdx | 239 ++++ .../website/src/content/docs/concepts.mdx | 85 ++ .../src/content/docs/configuration.mdx | 419 ++++++ .../website/src/content/docs/how-to-work.mdx | 103 ++ .../0.6.5/website/src/content/docs/index.mdx | 64 + .../website/src/content/docs/install.mdx | 107 ++ .../website/src/content/docs/integrations.mdx | 192 +++ .../src/content/docs/persistence-remote.mdx | 153 +++ .../website/src/content/docs/quick-start.mdx | 90 ++ .../src/content/docs/session-state.mdx | 94 ++ .../website/src/content/docs/socket-api.mdx | 292 +++++ .../website/src/content/docs/agent-skill.mdx | 55 + .../0.6.6/website/src/content/docs/agents.mdx | 138 ++ .../src/content/docs/cli-reference.mdx | 239 ++++ .../website/src/content/docs/concepts.mdx | 85 ++ .../src/content/docs/configuration.mdx | 431 +++++++ .../website/src/content/docs/how-to-work.mdx | 103 ++ .../0.6.6/website/src/content/docs/index.mdx | 64 + .../website/src/content/docs/install.mdx | 109 ++ .../website/src/content/docs/integrations.mdx | 192 +++ .../src/content/docs/persistence-remote.mdx | 153 +++ .../website/src/content/docs/quick-start.mdx | 90 ++ .../src/content/docs/session-state.mdx | 94 ++ .../website/src/content/docs/socket-api.mdx | 292 +++++ .../website/src/content/docs/agent-skill.mdx | 55 + .../0.6.7/website/src/content/docs/agents.mdx | 140 ++ .../src/content/docs/cli-reference.mdx | 244 ++++ .../website/src/content/docs/concepts.mdx | 85 ++ .../src/content/docs/configuration.mdx | 456 +++++++ .../website/src/content/docs/how-to-work.mdx | 103 ++ .../0.6.7/website/src/content/docs/index.mdx | 64 + .../website/src/content/docs/install.mdx | 125 ++ .../website/src/content/docs/integrations.mdx | 207 +++ .../src/content/docs/persistence-remote.mdx | 155 +++ .../website/src/content/docs/quick-start.mdx | 92 ++ .../src/content/docs/session-state.mdx | 98 ++ .../website/src/content/docs/socket-api.mdx | 306 +++++ .../website/src/content/docs/agent-skill.mdx | 55 + .../0.6.8/website/src/content/docs/agents.mdx | 140 ++ .../src/content/docs/cli-reference.mdx | 244 ++++ .../website/src/content/docs/concepts.mdx | 85 ++ .../src/content/docs/configuration.mdx | 471 +++++++ .../website/src/content/docs/how-to-work.mdx | 103 ++ .../0.6.8/website/src/content/docs/index.mdx | 64 + .../website/src/content/docs/install.mdx | 133 ++ .../website/src/content/docs/integrations.mdx | 207 +++ .../src/content/docs/persistence-remote.mdx | 155 +++ .../website/src/content/docs/quick-start.mdx | 92 ++ .../src/content/docs/session-state.mdx | 98 ++ .../website/src/content/docs/socket-api.mdx | 306 +++++ .../website/src/content/docs/agent-skill.mdx | 55 + .../0.6.9/website/src/content/docs/agents.mdx | 178 +++ .../src/content/docs/cli-reference.mdx | 276 ++++ .../website/src/content/docs/concepts.mdx | 85 ++ .../src/content/docs/configuration.mdx | 489 +++++++ .../website/src/content/docs/how-to-work.mdx | 103 ++ .../0.6.9/website/src/content/docs/index.mdx | 71 ++ .../website/src/content/docs/install.mdx | 151 +++ .../website/src/content/docs/integrations.mdx | 270 ++++ .../src/content/docs/persistence-remote.mdx | 159 +++ .../website/src/content/docs/quick-start.mdx | 92 ++ .../src/content/docs/session-state.mdx | 102 ++ .../website/src/content/docs/socket-api.mdx | 428 +++++++ .../website/src/content/docs/windows-beta.mdx | 97 ++ .../website/src/content/docs/agent-skill.mdx | 57 + .../0.7.0/website/src/content/docs/agents.mdx | 159 +++ .../src/content/docs/cli-reference.mdx | 369 ++++++ .../website/src/content/docs/concepts.mdx | 85 ++ .../src/content/docs/configuration.mdx | 502 ++++++++ .../website/src/content/docs/how-to-work.mdx | 103 ++ .../0.7.0/website/src/content/docs/index.mdx | 77 ++ .../website/src/content/docs/install.mdx | 151 +++ .../website/src/content/docs/integrations.mdx | 286 +++++ .../website/src/content/docs/keyboard.mdx | 112 ++ .../website/src/content/docs/marketplace.mdx | 37 + .../src/content/docs/persistence-remote.mdx | 132 ++ .../website/src/content/docs/plugins.mdx | 294 +++++ .../website/src/content/docs/quick-start.mdx | 69 + .../src/content/docs/session-state.mdx | 105 ++ .../website/src/content/docs/socket-api.mdx | 702 +++++++++++ .../website/src/content/docs/windows-beta.mdx | 100 ++ .../website/src/content/docs/agent-skill.mdx | 57 + .../0.7.1/website/src/content/docs/agents.mdx | 163 +++ .../src/content/docs/cli-reference.mdx | 369 ++++++ .../website/src/content/docs/concepts.mdx | 85 ++ .../src/content/docs/configuration.mdx | 527 ++++++++ .../website/src/content/docs/how-to-work.mdx | 103 ++ .../0.7.1/website/src/content/docs/index.mdx | 77 ++ .../website/src/content/docs/install.mdx | 151 +++ .../website/src/content/docs/integrations.mdx | 286 +++++ .../website/src/content/docs/keyboard.mdx | 112 ++ .../website/src/content/docs/marketplace.mdx | 53 + .../src/content/docs/persistence-remote.mdx | 132 ++ .../website/src/content/docs/plugins.mdx | 314 +++++ .../website/src/content/docs/quick-start.mdx | 69 + .../src/content/docs/session-state.mdx | 104 ++ .../website/src/content/docs/socket-api.mdx | 702 +++++++++++ .../website/src/content/docs/windows-beta.mdx | 100 ++ .../website/src/content/docs/agent-skill.mdx | 65 + .../0.7.2/website/src/content/docs/agents.mdx | 164 +++ .../src/content/docs/cli-reference.mdx | 438 +++++++ .../website/src/content/docs/concepts.mdx | 85 ++ .../src/content/docs/configuration.mdx | 538 ++++++++ .../website/src/content/docs/how-to-work.mdx | 103 ++ .../0.7.2/website/src/content/docs/index.mdx | 77 ++ .../website/src/content/docs/install.mdx | 151 +++ .../website/src/content/docs/integrations.mdx | 302 +++++ .../src/content/docs/ja/agent-skill.mdx | 65 + .../website/src/content/docs/ja/agents.mdx | 164 +++ .../src/content/docs/ja/cli-reference.mdx | 358 ++++++ .../website/src/content/docs/ja/concepts.mdx | 85 ++ .../src/content/docs/ja/configuration.mdx | 526 ++++++++ .../src/content/docs/ja/how-to-work.mdx | 103 ++ .../website/src/content/docs/ja/index.mdx | 77 ++ .../website/src/content/docs/ja/install.mdx | 151 +++ .../src/content/docs/ja/integrations.mdx | 302 +++++ .../website/src/content/docs/ja/keyboard.mdx | 112 ++ .../src/content/docs/ja/marketplace.mdx | 53 + .../content/docs/ja/persistence-remote.mdx | 132 ++ .../website/src/content/docs/ja/plugins.mdx | 318 +++++ .../src/content/docs/ja/quick-start.mdx | 69 + .../src/content/docs/ja/session-state.mdx | 105 ++ .../src/content/docs/ja/socket-api.mdx | 609 +++++++++ .../src/content/docs/ja/windows-beta.mdx | 100 ++ .../website/src/content/docs/keyboard.mdx | 112 ++ .../website/src/content/docs/marketplace.mdx | 53 + .../src/content/docs/persistence-remote.mdx | 165 +++ .../website/src/content/docs/plugins.mdx | 314 +++++ .../website/src/content/docs/quick-start.mdx | 69 + .../src/content/docs/session-state.mdx | 105 ++ .../website/src/content/docs/socket-api.mdx | 761 +++++++++++ .../website/src/content/docs/windows-beta.mdx | 118 ++ .../src/content/docs/zh-cn/agent-skill.mdx | 65 + .../website/src/content/docs/zh-cn/agents.mdx | 164 +++ .../src/content/docs/zh-cn/cli-reference.mdx | 358 ++++++ .../src/content/docs/zh-cn/concepts.mdx | 85 ++ .../src/content/docs/zh-cn/configuration.mdx | 526 ++++++++ .../src/content/docs/zh-cn/how-to-work.mdx | 103 ++ .../website/src/content/docs/zh-cn/index.mdx | 77 ++ .../src/content/docs/zh-cn/install.mdx | 151 +++ .../src/content/docs/zh-cn/integrations.mdx | 302 +++++ .../src/content/docs/zh-cn/keyboard.mdx | 112 ++ .../src/content/docs/zh-cn/marketplace.mdx | 44 + .../content/docs/zh-cn/persistence-remote.mdx | 132 ++ .../src/content/docs/zh-cn/plugins.mdx | 285 +++++ .../src/content/docs/zh-cn/quick-start.mdx | 69 + .../src/content/docs/zh-cn/session-state.mdx | 105 ++ .../src/content/docs/zh-cn/socket-api.mdx | 609 +++++++++ .../src/content/docs/zh-cn/windows-beta.mdx | 100 ++ .../website/src/content/docs/agent-skill.mdx | 65 + .../0.7.3/website/src/content/docs/agents.mdx | 164 +++ .../src/content/docs/cli-reference.mdx | 438 +++++++ .../website/src/content/docs/concepts.mdx | 85 ++ .../src/content/docs/configuration.mdx | 538 ++++++++ .../website/src/content/docs/how-to-work.mdx | 103 ++ .../0.7.3/website/src/content/docs/index.mdx | 77 ++ .../website/src/content/docs/install.mdx | 151 +++ .../website/src/content/docs/integrations.mdx | 302 +++++ .../src/content/docs/ja/agent-skill.mdx | 65 + .../website/src/content/docs/ja/agents.mdx | 164 +++ .../src/content/docs/ja/cli-reference.mdx | 358 ++++++ .../website/src/content/docs/ja/concepts.mdx | 85 ++ .../src/content/docs/ja/configuration.mdx | 526 ++++++++ .../src/content/docs/ja/how-to-work.mdx | 103 ++ .../website/src/content/docs/ja/index.mdx | 77 ++ .../website/src/content/docs/ja/install.mdx | 151 +++ .../src/content/docs/ja/integrations.mdx | 302 +++++ .../website/src/content/docs/ja/keyboard.mdx | 112 ++ .../src/content/docs/ja/marketplace.mdx | 53 + .../content/docs/ja/persistence-remote.mdx | 132 ++ .../website/src/content/docs/ja/plugins.mdx | 318 +++++ .../src/content/docs/ja/quick-start.mdx | 69 + .../src/content/docs/ja/session-state.mdx | 105 ++ .../src/content/docs/ja/socket-api.mdx | 609 +++++++++ .../src/content/docs/ja/windows-beta.mdx | 100 ++ .../website/src/content/docs/keyboard.mdx | 112 ++ .../website/src/content/docs/marketplace.mdx | 53 + .../src/content/docs/persistence-remote.mdx | 165 +++ .../website/src/content/docs/plugins.mdx | 314 +++++ .../website/src/content/docs/quick-start.mdx | 69 + .../src/content/docs/session-state.mdx | 105 ++ .../website/src/content/docs/socket-api.mdx | 761 +++++++++++ .../website/src/content/docs/windows-beta.mdx | 118 ++ .../src/content/docs/zh-cn/agent-skill.mdx | 65 + .../website/src/content/docs/zh-cn/agents.mdx | 164 +++ .../src/content/docs/zh-cn/cli-reference.mdx | 358 ++++++ .../src/content/docs/zh-cn/concepts.mdx | 85 ++ .../src/content/docs/zh-cn/configuration.mdx | 526 ++++++++ .../src/content/docs/zh-cn/how-to-work.mdx | 103 ++ .../website/src/content/docs/zh-cn/index.mdx | 77 ++ .../src/content/docs/zh-cn/install.mdx | 151 +++ .../src/content/docs/zh-cn/integrations.mdx | 302 +++++ .../src/content/docs/zh-cn/keyboard.mdx | 112 ++ .../src/content/docs/zh-cn/marketplace.mdx | 44 + .../content/docs/zh-cn/persistence-remote.mdx | 132 ++ .../src/content/docs/zh-cn/plugins.mdx | 285 +++++ .../src/content/docs/zh-cn/quick-start.mdx | 69 + .../src/content/docs/zh-cn/session-state.mdx | 105 ++ .../src/content/docs/zh-cn/socket-api.mdx | 609 +++++++++ .../src/content/docs/zh-cn/windows-beta.mdx | 100 ++ .../website/src/content/docs/agent-skill.mdx | 65 + .../0.7.4/website/src/content/docs/agents.mdx | 170 +++ .../src/content/docs/cli-reference.mdx | 446 +++++++ .../website/src/content/docs/concepts.mdx | 85 ++ .../src/content/docs/config-reference.mdx | 21 + .../src/content/docs/configuration.mdx | 452 +++++++ .../website/src/content/docs/how-to-work.mdx | 103 ++ .../0.7.4/website/src/content/docs/index.mdx | 77 ++ .../website/src/content/docs/install.mdx | 151 +++ .../website/src/content/docs/integrations.mdx | 299 +++++ .../src/content/docs/ja/agent-skill.mdx | 65 + .../website/src/content/docs/ja/agents.mdx | 170 +++ .../src/content/docs/ja/cli-reference.mdx | 404 ++++++ .../website/src/content/docs/ja/concepts.mdx | 85 ++ .../src/content/docs/ja/config-reference.mdx | 27 + .../src/content/docs/ja/configuration.mdx | 448 +++++++ .../src/content/docs/ja/how-to-work.mdx | 103 ++ .../website/src/content/docs/ja/index.mdx | 77 ++ .../website/src/content/docs/ja/install.mdx | 151 +++ .../src/content/docs/ja/integrations.mdx | 299 +++++ .../website/src/content/docs/ja/keyboard.mdx | 112 ++ .../src/content/docs/ja/marketplace.mdx | 53 + .../content/docs/ja/persistence-remote.mdx | 132 ++ .../website/src/content/docs/ja/plugins.mdx | 341 +++++ .../src/content/docs/ja/quick-start.mdx | 69 + .../src/content/docs/ja/session-state.mdx | 105 ++ .../src/content/docs/ja/socket-api.mdx | 676 ++++++++++ .../src/content/docs/ja/troubleshooting.mdx | 82 ++ .../src/content/docs/ja/windows-beta.mdx | 117 ++ .../website/src/content/docs/keyboard.mdx | 112 ++ .../website/src/content/docs/marketplace.mdx | 53 + .../src/content/docs/persistence-remote.mdx | 165 +++ .../website/src/content/docs/plugins.mdx | 343 +++++ .../website/src/content/docs/quick-start.mdx | 69 + .../src/content/docs/session-state.mdx | 105 ++ .../website/src/content/docs/socket-api.mdx | 808 ++++++++++++ .../src/content/docs/troubleshooting.mdx | 82 ++ .../website/src/content/docs/windows-beta.mdx | 118 ++ .../src/content/docs/zh-cn/agent-skill.mdx | 65 + .../website/src/content/docs/zh-cn/agents.mdx | 170 +++ .../src/content/docs/zh-cn/cli-reference.mdx | 404 ++++++ .../src/content/docs/zh-cn/concepts.mdx | 85 ++ .../content/docs/zh-cn/config-reference.mdx | 26 + .../src/content/docs/zh-cn/configuration.mdx | 448 +++++++ .../src/content/docs/zh-cn/how-to-work.mdx | 103 ++ .../website/src/content/docs/zh-cn/index.mdx | 77 ++ .../src/content/docs/zh-cn/install.mdx | 151 +++ .../src/content/docs/zh-cn/integrations.mdx | 299 +++++ .../src/content/docs/zh-cn/keyboard.mdx | 112 ++ .../src/content/docs/zh-cn/marketplace.mdx | 44 + .../content/docs/zh-cn/persistence-remote.mdx | 132 ++ .../src/content/docs/zh-cn/plugins.mdx | 306 +++++ .../src/content/docs/zh-cn/quick-start.mdx | 69 + .../src/content/docs/zh-cn/session-state.mdx | 105 ++ .../src/content/docs/zh-cn/socket-api.mdx | 676 ++++++++++ .../content/docs/zh-cn/troubleshooting.mdx | 82 ++ .../src/content/docs/zh-cn/windows-beta.mdx | 117 ++ .../website/src/data/config-reference.json | 1109 ++++++++++++++++ .../src/content/docs/agent-automation.mdx | 121 ++ .../website/src/content/docs/agent-skill.mdx | 65 + .../0.7.5/website/src/content/docs/agents.mdx | 154 +++ .../src/content/docs/cli-reference.mdx | 485 +++++++ .../website/src/content/docs/concepts.mdx | 85 ++ .../src/content/docs/config-reference.mdx | 21 + .../src/content/docs/configuration.mdx | 466 +++++++ .../website/src/content/docs/how-to-work.mdx | 103 ++ .../0.7.5/website/src/content/docs/index.mdx | 77 ++ .../website/src/content/docs/install.mdx | 151 +++ .../website/src/content/docs/integrations.mdx | 299 +++++ .../src/content/docs/ja/agent-automation.mdx | 121 ++ .../src/content/docs/ja/agent-skill.mdx | 65 + .../website/src/content/docs/ja/agents.mdx | 154 +++ .../src/content/docs/ja/cli-reference.mdx | 444 +++++++ .../website/src/content/docs/ja/concepts.mdx | 85 ++ .../src/content/docs/ja/config-reference.mdx | 27 + .../src/content/docs/ja/configuration.mdx | 462 +++++++ .../src/content/docs/ja/how-to-work.mdx | 103 ++ .../website/src/content/docs/ja/index.mdx | 77 ++ .../website/src/content/docs/ja/install.mdx | 151 +++ .../src/content/docs/ja/integrations.mdx | 299 +++++ .../website/src/content/docs/ja/keyboard.mdx | 112 ++ .../src/content/docs/ja/marketplace.mdx | 53 + .../content/docs/ja/persistence-remote.mdx | 132 ++ .../website/src/content/docs/ja/plugins.mdx | 367 ++++++ .../src/content/docs/ja/quick-start.mdx | 69 + .../src/content/docs/ja/session-state.mdx | 107 ++ .../src/content/docs/ja/socket-api.mdx | 750 +++++++++++ .../src/content/docs/ja/troubleshooting.mdx | 95 ++ .../src/content/docs/ja/windows-beta.mdx | 122 ++ .../website/src/content/docs/keyboard.mdx | 112 ++ .../website/src/content/docs/marketplace.mdx | 53 + .../src/content/docs/persistence-remote.mdx | 165 +++ .../website/src/content/docs/plugins.mdx | 372 ++++++ .../website/src/content/docs/quick-start.mdx | 69 + .../src/content/docs/session-state.mdx | 107 ++ .../website/src/content/docs/socket-api.mdx | 885 +++++++++++++ .../src/content/docs/troubleshooting.mdx | 95 ++ .../website/src/content/docs/windows-beta.mdx | 122 ++ .../content/docs/zh-cn/agent-automation.mdx | 121 ++ .../src/content/docs/zh-cn/agent-skill.mdx | 65 + .../website/src/content/docs/zh-cn/agents.mdx | 154 +++ .../src/content/docs/zh-cn/cli-reference.mdx | 444 +++++++ .../src/content/docs/zh-cn/concepts.mdx | 85 ++ .../content/docs/zh-cn/config-reference.mdx | 26 + .../src/content/docs/zh-cn/configuration.mdx | 462 +++++++ .../src/content/docs/zh-cn/how-to-work.mdx | 103 ++ .../website/src/content/docs/zh-cn/index.mdx | 77 ++ .../src/content/docs/zh-cn/install.mdx | 151 +++ .../src/content/docs/zh-cn/integrations.mdx | 299 +++++ .../src/content/docs/zh-cn/keyboard.mdx | 112 ++ .../src/content/docs/zh-cn/marketplace.mdx | 44 + .../content/docs/zh-cn/persistence-remote.mdx | 132 ++ .../src/content/docs/zh-cn/plugins.mdx | 328 +++++ .../src/content/docs/zh-cn/quick-start.mdx | 69 + .../src/content/docs/zh-cn/session-state.mdx | 107 ++ .../src/content/docs/zh-cn/socket-api.mdx | 746 +++++++++++ .../content/docs/zh-cn/troubleshooting.mdx | 95 ++ .../src/content/docs/zh-cn/windows-beta.mdx | 122 ++ .../website/src/data/config-reference.json | 1121 +++++++++++++++++ docs/versions/README.md | 13 + docs/versions/manifest.json | 101 ++ justfile | 46 +- scripts/test_preview.py | 30 +- website/.gitignore | 3 + website/README.md | 10 + website/astro.config.mjs | 11 +- website/bun.lock | 1 + website/index.html | 2 +- website/package.json | 5 +- website/scripts/check-built-docs.mjs | 100 ++ .../scripts/docs-versions.integration.test.ts | 73 ++ website/scripts/docs-versions.mjs | 308 +++++ website/scripts/docs-versions.test.ts | 33 + website/scripts/prepare-docs.mjs | 173 ++- website/src/components/Banner.astro | 29 +- website/src/components/ConfigReference.astro | 13 +- .../src/components/DocsVersionSelect.astro | 84 ++ website/src/components/Head.astro | 7 +- website/src/components/Header.astro | 58 +- website/src/components/Search.astro | 28 +- website/src/components/Sidebar.astro | 73 +- website/src/components/SiteTitle.astro | 7 +- website/src/docs-path.test.ts | 49 +- website/src/docs-path.ts | 83 +- 451 files changed, 78392 insertions(+), 207 deletions(-) create mode 100644 .github/workflows/website.yml create mode 100644 docs/versions/0.5.11/website/src/content/docs/agent-skill.mdx create mode 100644 docs/versions/0.5.11/website/src/content/docs/agents.mdx create mode 100644 docs/versions/0.5.11/website/src/content/docs/cli-reference.mdx create mode 100644 docs/versions/0.5.11/website/src/content/docs/concepts.mdx create mode 100644 docs/versions/0.5.11/website/src/content/docs/configuration.mdx create mode 100644 docs/versions/0.5.11/website/src/content/docs/index.mdx create mode 100644 docs/versions/0.5.11/website/src/content/docs/install.mdx create mode 100644 docs/versions/0.5.11/website/src/content/docs/integrations.mdx create mode 100644 docs/versions/0.5.11/website/src/content/docs/persistence-remote.mdx create mode 100644 docs/versions/0.5.11/website/src/content/docs/quick-start.mdx create mode 100644 docs/versions/0.5.11/website/src/content/docs/socket-api.mdx create mode 100644 docs/versions/0.5.12/website/src/content/docs/agent-skill.mdx create mode 100644 docs/versions/0.5.12/website/src/content/docs/agents.mdx create mode 100644 docs/versions/0.5.12/website/src/content/docs/cli-reference.mdx create mode 100644 docs/versions/0.5.12/website/src/content/docs/concepts.mdx create mode 100644 docs/versions/0.5.12/website/src/content/docs/configuration.mdx create mode 100644 docs/versions/0.5.12/website/src/content/docs/how-to-work.mdx create mode 100644 docs/versions/0.5.12/website/src/content/docs/index.mdx create mode 100644 docs/versions/0.5.12/website/src/content/docs/install.mdx create mode 100644 docs/versions/0.5.12/website/src/content/docs/integrations.mdx create mode 100644 docs/versions/0.5.12/website/src/content/docs/persistence-remote.mdx create mode 100644 docs/versions/0.5.12/website/src/content/docs/quick-start.mdx create mode 100644 docs/versions/0.5.12/website/src/content/docs/socket-api.mdx create mode 100644 docs/versions/0.6.0/website/src/content/docs/agent-skill.mdx create mode 100644 docs/versions/0.6.0/website/src/content/docs/agents.mdx create mode 100644 docs/versions/0.6.0/website/src/content/docs/cli-reference.mdx create mode 100644 docs/versions/0.6.0/website/src/content/docs/concepts.mdx create mode 100644 docs/versions/0.6.0/website/src/content/docs/configuration.mdx create mode 100644 docs/versions/0.6.0/website/src/content/docs/how-to-work.mdx create mode 100644 docs/versions/0.6.0/website/src/content/docs/index.mdx create mode 100644 docs/versions/0.6.0/website/src/content/docs/install.mdx create mode 100644 docs/versions/0.6.0/website/src/content/docs/integrations.mdx create mode 100644 docs/versions/0.6.0/website/src/content/docs/persistence-remote.mdx create mode 100644 docs/versions/0.6.0/website/src/content/docs/quick-start.mdx create mode 100644 docs/versions/0.6.0/website/src/content/docs/socket-api.mdx create mode 100644 docs/versions/0.6.1/website/src/content/docs/agent-skill.mdx create mode 100644 docs/versions/0.6.1/website/src/content/docs/agents.mdx create mode 100644 docs/versions/0.6.1/website/src/content/docs/cli-reference.mdx create mode 100644 docs/versions/0.6.1/website/src/content/docs/concepts.mdx create mode 100644 docs/versions/0.6.1/website/src/content/docs/configuration.mdx create mode 100644 docs/versions/0.6.1/website/src/content/docs/how-to-work.mdx create mode 100644 docs/versions/0.6.1/website/src/content/docs/index.mdx create mode 100644 docs/versions/0.6.1/website/src/content/docs/install.mdx create mode 100644 docs/versions/0.6.1/website/src/content/docs/integrations.mdx create mode 100644 docs/versions/0.6.1/website/src/content/docs/persistence-remote.mdx create mode 100644 docs/versions/0.6.1/website/src/content/docs/quick-start.mdx create mode 100644 docs/versions/0.6.1/website/src/content/docs/socket-api.mdx create mode 100644 docs/versions/0.6.10/website/src/content/docs/agent-skill.mdx create mode 100644 docs/versions/0.6.10/website/src/content/docs/agents.mdx create mode 100644 docs/versions/0.6.10/website/src/content/docs/cli-reference.mdx create mode 100644 docs/versions/0.6.10/website/src/content/docs/concepts.mdx create mode 100644 docs/versions/0.6.10/website/src/content/docs/configuration.mdx create mode 100644 docs/versions/0.6.10/website/src/content/docs/how-to-work.mdx create mode 100644 docs/versions/0.6.10/website/src/content/docs/index.mdx create mode 100644 docs/versions/0.6.10/website/src/content/docs/install.mdx create mode 100644 docs/versions/0.6.10/website/src/content/docs/integrations.mdx create mode 100644 docs/versions/0.6.10/website/src/content/docs/persistence-remote.mdx create mode 100644 docs/versions/0.6.10/website/src/content/docs/quick-start.mdx create mode 100644 docs/versions/0.6.10/website/src/content/docs/session-state.mdx create mode 100644 docs/versions/0.6.10/website/src/content/docs/socket-api.mdx create mode 100644 docs/versions/0.6.10/website/src/content/docs/windows-beta.mdx create mode 100644 docs/versions/0.6.2/website/src/content/docs/agent-skill.mdx create mode 100644 docs/versions/0.6.2/website/src/content/docs/agents.mdx create mode 100644 docs/versions/0.6.2/website/src/content/docs/cli-reference.mdx create mode 100644 docs/versions/0.6.2/website/src/content/docs/concepts.mdx create mode 100644 docs/versions/0.6.2/website/src/content/docs/configuration.mdx create mode 100644 docs/versions/0.6.2/website/src/content/docs/how-to-work.mdx create mode 100644 docs/versions/0.6.2/website/src/content/docs/index.mdx create mode 100644 docs/versions/0.6.2/website/src/content/docs/install.mdx create mode 100644 docs/versions/0.6.2/website/src/content/docs/integrations.mdx create mode 100644 docs/versions/0.6.2/website/src/content/docs/persistence-remote.mdx create mode 100644 docs/versions/0.6.2/website/src/content/docs/quick-start.mdx create mode 100644 docs/versions/0.6.2/website/src/content/docs/socket-api.mdx create mode 100644 docs/versions/0.6.3/website/src/content/docs/agent-skill.mdx create mode 100644 docs/versions/0.6.3/website/src/content/docs/agents.mdx create mode 100644 docs/versions/0.6.3/website/src/content/docs/cli-reference.mdx create mode 100644 docs/versions/0.6.3/website/src/content/docs/concepts.mdx create mode 100644 docs/versions/0.6.3/website/src/content/docs/configuration.mdx create mode 100644 docs/versions/0.6.3/website/src/content/docs/how-to-work.mdx create mode 100644 docs/versions/0.6.3/website/src/content/docs/index.mdx create mode 100644 docs/versions/0.6.3/website/src/content/docs/install.mdx create mode 100644 docs/versions/0.6.3/website/src/content/docs/integrations.mdx create mode 100644 docs/versions/0.6.3/website/src/content/docs/persistence-remote.mdx create mode 100644 docs/versions/0.6.3/website/src/content/docs/quick-start.mdx create mode 100644 docs/versions/0.6.3/website/src/content/docs/session-state.mdx create mode 100644 docs/versions/0.6.3/website/src/content/docs/socket-api.mdx create mode 100644 docs/versions/0.6.4/website/src/content/docs/agent-skill.mdx create mode 100644 docs/versions/0.6.4/website/src/content/docs/agents.mdx create mode 100644 docs/versions/0.6.4/website/src/content/docs/cli-reference.mdx create mode 100644 docs/versions/0.6.4/website/src/content/docs/concepts.mdx create mode 100644 docs/versions/0.6.4/website/src/content/docs/configuration.mdx create mode 100644 docs/versions/0.6.4/website/src/content/docs/how-to-work.mdx create mode 100644 docs/versions/0.6.4/website/src/content/docs/index.mdx create mode 100644 docs/versions/0.6.4/website/src/content/docs/install.mdx create mode 100644 docs/versions/0.6.4/website/src/content/docs/integrations.mdx create mode 100644 docs/versions/0.6.4/website/src/content/docs/persistence-remote.mdx create mode 100644 docs/versions/0.6.4/website/src/content/docs/quick-start.mdx create mode 100644 docs/versions/0.6.4/website/src/content/docs/session-state.mdx create mode 100644 docs/versions/0.6.4/website/src/content/docs/socket-api.mdx create mode 100644 docs/versions/0.6.5/website/src/content/docs/agent-skill.mdx create mode 100644 docs/versions/0.6.5/website/src/content/docs/agents.mdx create mode 100644 docs/versions/0.6.5/website/src/content/docs/cli-reference.mdx create mode 100644 docs/versions/0.6.5/website/src/content/docs/concepts.mdx create mode 100644 docs/versions/0.6.5/website/src/content/docs/configuration.mdx create mode 100644 docs/versions/0.6.5/website/src/content/docs/how-to-work.mdx create mode 100644 docs/versions/0.6.5/website/src/content/docs/index.mdx create mode 100644 docs/versions/0.6.5/website/src/content/docs/install.mdx create mode 100644 docs/versions/0.6.5/website/src/content/docs/integrations.mdx create mode 100644 docs/versions/0.6.5/website/src/content/docs/persistence-remote.mdx create mode 100644 docs/versions/0.6.5/website/src/content/docs/quick-start.mdx create mode 100644 docs/versions/0.6.5/website/src/content/docs/session-state.mdx create mode 100644 docs/versions/0.6.5/website/src/content/docs/socket-api.mdx create mode 100644 docs/versions/0.6.6/website/src/content/docs/agent-skill.mdx create mode 100644 docs/versions/0.6.6/website/src/content/docs/agents.mdx create mode 100644 docs/versions/0.6.6/website/src/content/docs/cli-reference.mdx create mode 100644 docs/versions/0.6.6/website/src/content/docs/concepts.mdx create mode 100644 docs/versions/0.6.6/website/src/content/docs/configuration.mdx create mode 100644 docs/versions/0.6.6/website/src/content/docs/how-to-work.mdx create mode 100644 docs/versions/0.6.6/website/src/content/docs/index.mdx create mode 100644 docs/versions/0.6.6/website/src/content/docs/install.mdx create mode 100644 docs/versions/0.6.6/website/src/content/docs/integrations.mdx create mode 100644 docs/versions/0.6.6/website/src/content/docs/persistence-remote.mdx create mode 100644 docs/versions/0.6.6/website/src/content/docs/quick-start.mdx create mode 100644 docs/versions/0.6.6/website/src/content/docs/session-state.mdx create mode 100644 docs/versions/0.6.6/website/src/content/docs/socket-api.mdx create mode 100644 docs/versions/0.6.7/website/src/content/docs/agent-skill.mdx create mode 100644 docs/versions/0.6.7/website/src/content/docs/agents.mdx create mode 100644 docs/versions/0.6.7/website/src/content/docs/cli-reference.mdx create mode 100644 docs/versions/0.6.7/website/src/content/docs/concepts.mdx create mode 100644 docs/versions/0.6.7/website/src/content/docs/configuration.mdx create mode 100644 docs/versions/0.6.7/website/src/content/docs/how-to-work.mdx create mode 100644 docs/versions/0.6.7/website/src/content/docs/index.mdx create mode 100644 docs/versions/0.6.7/website/src/content/docs/install.mdx create mode 100644 docs/versions/0.6.7/website/src/content/docs/integrations.mdx create mode 100644 docs/versions/0.6.7/website/src/content/docs/persistence-remote.mdx create mode 100644 docs/versions/0.6.7/website/src/content/docs/quick-start.mdx create mode 100644 docs/versions/0.6.7/website/src/content/docs/session-state.mdx create mode 100644 docs/versions/0.6.7/website/src/content/docs/socket-api.mdx create mode 100644 docs/versions/0.6.8/website/src/content/docs/agent-skill.mdx create mode 100644 docs/versions/0.6.8/website/src/content/docs/agents.mdx create mode 100644 docs/versions/0.6.8/website/src/content/docs/cli-reference.mdx create mode 100644 docs/versions/0.6.8/website/src/content/docs/concepts.mdx create mode 100644 docs/versions/0.6.8/website/src/content/docs/configuration.mdx create mode 100644 docs/versions/0.6.8/website/src/content/docs/how-to-work.mdx create mode 100644 docs/versions/0.6.8/website/src/content/docs/index.mdx create mode 100644 docs/versions/0.6.8/website/src/content/docs/install.mdx create mode 100644 docs/versions/0.6.8/website/src/content/docs/integrations.mdx create mode 100644 docs/versions/0.6.8/website/src/content/docs/persistence-remote.mdx create mode 100644 docs/versions/0.6.8/website/src/content/docs/quick-start.mdx create mode 100644 docs/versions/0.6.8/website/src/content/docs/session-state.mdx create mode 100644 docs/versions/0.6.8/website/src/content/docs/socket-api.mdx create mode 100644 docs/versions/0.6.9/website/src/content/docs/agent-skill.mdx create mode 100644 docs/versions/0.6.9/website/src/content/docs/agents.mdx create mode 100644 docs/versions/0.6.9/website/src/content/docs/cli-reference.mdx create mode 100644 docs/versions/0.6.9/website/src/content/docs/concepts.mdx create mode 100644 docs/versions/0.6.9/website/src/content/docs/configuration.mdx create mode 100644 docs/versions/0.6.9/website/src/content/docs/how-to-work.mdx create mode 100644 docs/versions/0.6.9/website/src/content/docs/index.mdx create mode 100644 docs/versions/0.6.9/website/src/content/docs/install.mdx create mode 100644 docs/versions/0.6.9/website/src/content/docs/integrations.mdx create mode 100644 docs/versions/0.6.9/website/src/content/docs/persistence-remote.mdx create mode 100644 docs/versions/0.6.9/website/src/content/docs/quick-start.mdx create mode 100644 docs/versions/0.6.9/website/src/content/docs/session-state.mdx create mode 100644 docs/versions/0.6.9/website/src/content/docs/socket-api.mdx create mode 100644 docs/versions/0.6.9/website/src/content/docs/windows-beta.mdx create mode 100644 docs/versions/0.7.0/website/src/content/docs/agent-skill.mdx create mode 100644 docs/versions/0.7.0/website/src/content/docs/agents.mdx create mode 100644 docs/versions/0.7.0/website/src/content/docs/cli-reference.mdx create mode 100644 docs/versions/0.7.0/website/src/content/docs/concepts.mdx create mode 100644 docs/versions/0.7.0/website/src/content/docs/configuration.mdx create mode 100644 docs/versions/0.7.0/website/src/content/docs/how-to-work.mdx create mode 100644 docs/versions/0.7.0/website/src/content/docs/index.mdx create mode 100644 docs/versions/0.7.0/website/src/content/docs/install.mdx create mode 100644 docs/versions/0.7.0/website/src/content/docs/integrations.mdx create mode 100644 docs/versions/0.7.0/website/src/content/docs/keyboard.mdx create mode 100644 docs/versions/0.7.0/website/src/content/docs/marketplace.mdx create mode 100644 docs/versions/0.7.0/website/src/content/docs/persistence-remote.mdx create mode 100644 docs/versions/0.7.0/website/src/content/docs/plugins.mdx create mode 100644 docs/versions/0.7.0/website/src/content/docs/quick-start.mdx create mode 100644 docs/versions/0.7.0/website/src/content/docs/session-state.mdx create mode 100644 docs/versions/0.7.0/website/src/content/docs/socket-api.mdx create mode 100644 docs/versions/0.7.0/website/src/content/docs/windows-beta.mdx create mode 100644 docs/versions/0.7.1/website/src/content/docs/agent-skill.mdx create mode 100644 docs/versions/0.7.1/website/src/content/docs/agents.mdx create mode 100644 docs/versions/0.7.1/website/src/content/docs/cli-reference.mdx create mode 100644 docs/versions/0.7.1/website/src/content/docs/concepts.mdx create mode 100644 docs/versions/0.7.1/website/src/content/docs/configuration.mdx create mode 100644 docs/versions/0.7.1/website/src/content/docs/how-to-work.mdx create mode 100644 docs/versions/0.7.1/website/src/content/docs/index.mdx create mode 100644 docs/versions/0.7.1/website/src/content/docs/install.mdx create mode 100644 docs/versions/0.7.1/website/src/content/docs/integrations.mdx create mode 100644 docs/versions/0.7.1/website/src/content/docs/keyboard.mdx create mode 100644 docs/versions/0.7.1/website/src/content/docs/marketplace.mdx create mode 100644 docs/versions/0.7.1/website/src/content/docs/persistence-remote.mdx create mode 100644 docs/versions/0.7.1/website/src/content/docs/plugins.mdx create mode 100644 docs/versions/0.7.1/website/src/content/docs/quick-start.mdx create mode 100644 docs/versions/0.7.1/website/src/content/docs/session-state.mdx create mode 100644 docs/versions/0.7.1/website/src/content/docs/socket-api.mdx create mode 100644 docs/versions/0.7.1/website/src/content/docs/windows-beta.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/agent-skill.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/agents.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/cli-reference.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/concepts.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/configuration.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/how-to-work.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/index.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/install.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/integrations.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/ja/agent-skill.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/ja/agents.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/ja/cli-reference.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/ja/concepts.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/ja/configuration.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/ja/how-to-work.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/ja/index.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/ja/install.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/ja/integrations.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/ja/keyboard.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/ja/marketplace.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/ja/persistence-remote.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/ja/plugins.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/ja/quick-start.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/ja/session-state.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/ja/socket-api.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/ja/windows-beta.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/keyboard.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/marketplace.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/persistence-remote.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/plugins.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/quick-start.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/session-state.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/socket-api.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/windows-beta.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/zh-cn/agent-skill.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/zh-cn/agents.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/zh-cn/cli-reference.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/zh-cn/concepts.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/zh-cn/configuration.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/zh-cn/how-to-work.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/zh-cn/index.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/zh-cn/install.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/zh-cn/integrations.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/zh-cn/keyboard.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/zh-cn/marketplace.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/zh-cn/persistence-remote.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/zh-cn/plugins.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/zh-cn/quick-start.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/zh-cn/session-state.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/zh-cn/socket-api.mdx create mode 100644 docs/versions/0.7.2/website/src/content/docs/zh-cn/windows-beta.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/agent-skill.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/agents.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/cli-reference.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/concepts.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/configuration.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/how-to-work.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/index.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/install.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/integrations.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/ja/agent-skill.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/ja/agents.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/ja/cli-reference.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/ja/concepts.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/ja/configuration.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/ja/how-to-work.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/ja/index.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/ja/install.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/ja/integrations.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/ja/keyboard.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/ja/marketplace.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/ja/persistence-remote.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/ja/plugins.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/ja/quick-start.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/ja/session-state.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/ja/socket-api.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/ja/windows-beta.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/keyboard.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/marketplace.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/persistence-remote.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/plugins.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/quick-start.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/session-state.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/socket-api.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/windows-beta.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/zh-cn/agent-skill.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/zh-cn/agents.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/zh-cn/cli-reference.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/zh-cn/concepts.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/zh-cn/configuration.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/zh-cn/how-to-work.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/zh-cn/index.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/zh-cn/install.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/zh-cn/integrations.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/zh-cn/keyboard.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/zh-cn/marketplace.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/zh-cn/persistence-remote.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/zh-cn/plugins.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/zh-cn/quick-start.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/zh-cn/session-state.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/zh-cn/socket-api.mdx create mode 100644 docs/versions/0.7.3/website/src/content/docs/zh-cn/windows-beta.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/agent-skill.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/agents.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/cli-reference.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/concepts.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/config-reference.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/configuration.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/how-to-work.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/index.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/install.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/integrations.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/ja/agent-skill.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/ja/agents.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/ja/cli-reference.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/ja/concepts.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/ja/config-reference.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/ja/configuration.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/ja/how-to-work.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/ja/index.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/ja/install.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/ja/integrations.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/ja/keyboard.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/ja/marketplace.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/ja/persistence-remote.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/ja/plugins.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/ja/quick-start.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/ja/session-state.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/ja/socket-api.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/ja/troubleshooting.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/ja/windows-beta.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/keyboard.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/marketplace.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/persistence-remote.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/plugins.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/quick-start.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/session-state.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/socket-api.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/troubleshooting.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/windows-beta.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/zh-cn/agent-skill.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/zh-cn/agents.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/zh-cn/cli-reference.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/zh-cn/concepts.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/zh-cn/config-reference.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/zh-cn/configuration.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/zh-cn/how-to-work.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/zh-cn/index.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/zh-cn/install.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/zh-cn/integrations.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/zh-cn/keyboard.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/zh-cn/marketplace.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/zh-cn/persistence-remote.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/zh-cn/plugins.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/zh-cn/quick-start.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/zh-cn/session-state.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/zh-cn/socket-api.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/zh-cn/troubleshooting.mdx create mode 100644 docs/versions/0.7.4/website/src/content/docs/zh-cn/windows-beta.mdx create mode 100644 docs/versions/0.7.4/website/src/data/config-reference.json create mode 100644 docs/versions/0.7.5/website/src/content/docs/agent-automation.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/agent-skill.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/agents.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/cli-reference.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/concepts.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/config-reference.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/configuration.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/how-to-work.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/index.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/install.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/integrations.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/ja/agent-automation.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/ja/agent-skill.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/ja/agents.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/ja/cli-reference.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/ja/concepts.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/ja/config-reference.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/ja/configuration.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/ja/how-to-work.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/ja/index.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/ja/install.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/ja/integrations.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/ja/keyboard.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/ja/marketplace.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/ja/persistence-remote.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/ja/plugins.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/ja/quick-start.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/ja/session-state.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/ja/socket-api.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/ja/troubleshooting.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/ja/windows-beta.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/keyboard.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/marketplace.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/persistence-remote.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/plugins.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/quick-start.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/session-state.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/socket-api.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/troubleshooting.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/windows-beta.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/zh-cn/agent-automation.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/zh-cn/agent-skill.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/zh-cn/agents.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/zh-cn/cli-reference.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/zh-cn/concepts.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/zh-cn/config-reference.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/zh-cn/configuration.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/zh-cn/how-to-work.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/zh-cn/index.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/zh-cn/install.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/zh-cn/integrations.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/zh-cn/keyboard.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/zh-cn/marketplace.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/zh-cn/persistence-remote.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/zh-cn/plugins.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/zh-cn/quick-start.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/zh-cn/session-state.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/zh-cn/socket-api.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/zh-cn/troubleshooting.mdx create mode 100644 docs/versions/0.7.5/website/src/content/docs/zh-cn/windows-beta.mdx create mode 100644 docs/versions/0.7.5/website/src/data/config-reference.json create mode 100644 docs/versions/README.md create mode 100644 docs/versions/manifest.json create mode 100644 website/scripts/check-built-docs.mjs create mode 100644 website/scripts/docs-versions.integration.test.ts create mode 100644 website/scripts/docs-versions.mjs create mode 100644 website/scripts/docs-versions.test.ts create mode 100644 website/src/components/DocsVersionSelect.astro diff --git a/.github/workflows/preview.yml b/.github/workflows/preview.yml index fabb2edc..370028fe 100644 --- a/.github/workflows/preview.yml +++ b/.github/workflows/preview.yml @@ -368,7 +368,19 @@ jobs: git config user.email "285672167+kangal-bot@users.noreply.github.com" git add website/preview.json git diff --cached --quiet || git commit -m "docs: update preview manifest" - git push "https://x-access-token:${KANGAL_GITHUB_TOKEN}@github.com/${GITHUB_REPOSITORY}.git" HEAD:master + remote="https://x-access-token:${KANGAL_GITHUB_TOKEN}@github.com/${GITHUB_REPOSITORY}.git" + for attempt in 1 2 3; do + git pull --rebase "$remote" master + if git push "$remote" HEAD:master; then + exit 0 + fi + if [ "$attempt" -lt 3 ]; then + echo "master changed during preview publishing; retrying ($attempt/3)" + sleep $((attempt * 2)) + fi + done + echo "failed to publish preview manifest after 3 attempts" >&2 + exit 1 - name: Mark preview-released issues continue-on-error: true diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 2d07a8f8..024998d2 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -342,11 +342,17 @@ jobs: fetch-depth: 0 ssh-key: ${{ secrets.RELEASE_DEPLOY_KEY }} - - name: Update website latest manifest + - name: Install Bun + uses: oven-sh/setup-bun@0c5077e51419868618aeaa5fe8019c62421857d6 # v2 + with: + bun-version: 1.3.14 + + - name: Publish tagged documentation and update website manifest env: GH_TOKEN: ${{ github.token }} run: | VERSION="${GITHUB_REF_NAME#v}" + node website/scripts/docs-versions.mjs publish "$GITHUB_REF_NAME" ANNOUNCEMENT_PATH="$RUNNER_TEMP/product-announcement.json" ANNOUNCEMENT_ORIGINAL_PATH="$RUNNER_TEMP/product-announcement-original.json" git show "${GITHUB_REF_NAME}:docs/next/product-announcement.json" > "$ANNOUNCEMENT_PATH" @@ -371,9 +377,22 @@ jobs: VERSION="${GITHUB_REF_NAME#v}" git config user.name "github-actions[bot]" git config user.email "41898282+github-actions[bot]@users.noreply.github.com" - git add website/latest.json docs/next/product-announcement.json + git add README.md docs/versions website/latest.json website/src/content/docs website/src/data/config-reference.json docs/next/product-announcement.json git diff --cached --quiet || git commit -m "docs: update website manifest for v$VERSION" - git push origin master + for attempt in 1 2 3; do + git pull --rebase origin master + node website/scripts/docs-versions.mjs check + (cd website && bun install --frozen-lockfile && bun run build) + if git push origin master; then + exit 0 + fi + if [ "$attempt" -lt 3 ]; then + echo "master changed during release publishing; retrying ($attempt/3)" + sleep $((attempt * 2)) + fi + done + echo "failed to publish release documentation after 3 attempts" >&2 + exit 1 - name: Trigger website deploy env: diff --git a/.github/workflows/website.yml b/.github/workflows/website.yml new file mode 100644 index 00000000..4cc922d8 --- /dev/null +++ b/.github/workflows/website.yml @@ -0,0 +1,47 @@ +name: Website + +on: + pull_request: + paths: + - ".github/workflows/website.yml" + - "website/**" + - "docs/next/website/**" + - "docs/versions/**" + - "scripts/test_preview.py" + push: + branches: [master] + paths: + - ".github/workflows/website.yml" + - "website/**" + - "docs/next/website/**" + - "docs/versions/**" + - "scripts/test_preview.py" + +permissions: + contents: read + +concurrency: + group: website-${{ github.event.pull_request.number || github.ref }} + cancel-in-progress: true + +jobs: + build: + runs-on: ubuntu-latest + timeout-minutes: 10 + steps: + - name: Checkout + uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6 + with: + fetch-depth: 0 + persist-credentials: false + + - name: Install Bun + uses: oven-sh/setup-bun@0c5077e51419868618aeaa5fe8019c62421857d6 # v2 + with: + bun-version: 1.3.14 + + - name: Validate version snapshots + run: node website/scripts/docs-versions.mjs check + + - name: Build website + run: cd website && bun install --frozen-lockfile && bun run build diff --git a/.gitignore b/.gitignore index e59f3475..e35d515f 100644 --- a/.gitignore +++ b/.gitignore @@ -10,6 +10,8 @@ __pycache__/ /docs/* !/docs/next/ !/docs/next/** +!/docs/versions/ +!/docs/versions/** /.local/ /backlog diff --git a/AGENTS.md b/AGENTS.md index 7fc7a08a..48024902 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -154,9 +154,9 @@ Stable public docs live in `website/src/content/docs/`. They are the currently r Unreleased docs live in `docs/next/website/src/content/docs/`. Update those when a user-facing change needs docs before the next release. `docs/next/README.md` and `docs/next/CHANGELOG.md` stage root README and changelog changes. -The website build runs `website/scripts/prepare-docs.mjs`. It keeps stable docs at `/docs/` and generates preview docs at `/docs/preview/` from `docs/next/website/src/content/docs/`. Do not edit generated `website/src/content/docs/preview/`. +The website build runs `website/scripts/prepare-docs.mjs`. It keeps stable docs at `/docs/`, generates next docs at `/docs/preview/` from `docs/next/website/src/content/docs/`, and generates immutable release docs from `docs/versions/`. Do not edit generated `website/src/content/docs/preview/` or `website/src/content/docs/_versions/`. -During release review, copy approved next docs into the stable docs and run `just release-docs-check`. Normal feature/fix work should not edit root `README.md`, root `CHANGELOG.md`, or `website/latest.json` unless explicitly requested. +During release review, finalize `docs/next` and run `just release-docs-check`. Do not copy next docs into the stable website manually. After the GitHub Release succeeds, release CI snapshots the tagged next docs, promotes them to stable, updates `latest.json`, and deploys them together. Normal feature/fix work should not edit root `README.md`, root `CHANGELOG.md`, stable website docs, or `website/latest.json` unless explicitly requested. Put local PRDs, planning notes, and exploratory specs under `.local/prd/`; `.local/` is ignored and locally controlled. @@ -217,7 +217,7 @@ just check just release 0.x.y ``` -Before stable release, run `/pre-release-audit`, finalize `docs/next`, copy approved docs into the stable docs/root files, and let `just release-docs-check` verify the sync. `just release` prepares the release commit, tags it, pushes the tag, and GitHub Actions builds binaries, creates the GitHub release, closes released issues, and updates `website/latest.json`. +Before stable release, run `/pre-release-audit`, finalize `docs/next`, and let `just release-docs-check` validate the staged docs and website build. `just release` prepares the changelog and release commit, tags it, and pushes the tag. GitHub Actions builds binaries, creates the GitHub release, closes released issues, snapshots and promotes the tagged docs, and updates `website/latest.json`. The release workflows must publish these four assets: diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 8309909e..974e9d49 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -69,7 +69,7 @@ If your proposal changes the visual language, interaction model, workflow, persi The root `README.md`, root `CHANGELOG.md`, and website docs describe the latest released version of herdr. Do not update root `README.md`, root `CHANGELOG.md`, or `website/src/content/docs/` for normal PRs. -If your PR changes user-facing behavior, mention the needed public-doc update in the PR. Update `docs/next/README.md` only when the root README needs to change for the next release. Update the full website-doc mirror under `docs/next/website/src/content/docs/` when website docs need to change for the next release. +If your PR changes user-facing behavior, mention the needed public-doc update in the PR. Update `docs/next/README.md` only when the root README needs to change for the next release. Update the full website-doc mirror under `docs/next/website/src/content/docs/` when website docs need to change for the next release. Release CI promotes the tagged next docs only after the GitHub Release succeeds; contributors and maintainers do not copy them into stable docs manually. You do not need to edit the changelog for normal PRs. Maintainers prepare `docs/next/CHANGELOG.md` during release review. diff --git a/docs/versions/0.5.11/website/src/content/docs/agent-skill.mdx b/docs/versions/0.5.11/website/src/content/docs/agent-skill.mdx new file mode 100644 index 00000000..65327c33 --- /dev/null +++ b/docs/versions/0.5.11/website/src/content/docs/agent-skill.mdx @@ -0,0 +1,103 @@ +--- +title: Agent skill +description: A concise guide for coding agents running inside Herdr. +--- + +This page teaches coding agents how to use Herdr while they are running inside a Herdr pane. + +Use Herdr to organize parallel work instead of stacking everything in one terminal. + +## Core model + +Herdr has four levels: + +| Level | Meaning | +| --- | --- | +| Workspace | A project or task context. | +| Tab | A view inside a workspace. | +| Pane | A terminal area inside a tab. | +| Agent | A detected coding agent running in a pane. | + +Use workspace and tab actions for layout. Use pane actions for commands and output. + +## Read the current layout + +```bash +herdr pane list +``` + +Use the pane IDs returned by Herdr for later commands. + +## Create a helper pane + +Split a pane and run a command: + +```bash +herdr pane split 1-1 --direction right +herdr pane run 1-2 "just test" +``` + +Prefer `pane run` over sending raw keys when you want to submit a full command line. + +## Read output + +```bash +herdr pane read 1-2 --source recent --lines 80 +``` + +Use `recent-unwrapped` when reading logs or matching long lines. + +```bash +herdr pane read 1-2 --source recent-unwrapped --lines 120 +``` + +## Wait for agents + +Wait for another agent to finish or become blocked: + +```bash +herdr wait agent-status 1-3 --status done +herdr wait agent-status 1-3 --status blocked +``` + +Use agent waits for recognized coding agents. Use normal output matching for ordinary commands, servers, and tests. + +## Preserve focus + +Do not steal visible focus unless the user asked for it. Create panes, submit commands, and read output without changing the user’s active view when possible. + +## Use clear pane aliases + +When your tool supports aliases, use names like `server`, `tests`, `reviewer`, or `docs`. This makes later pane operations easier to audit. + +## Good patterns + +Run long work in a separate pane: + +```bash +herdr pane split 1-1 --direction right +herdr pane run 1-2 "just check" +``` + +Watch a server until it is ready: + +```bash +herdr pane read 1-2 --source recent-unwrapped --lines 80 +``` + +Ask a reviewer agent to inspect a change: + +```bash +herdr pane split 1-1 --direction right +herdr pane run 1-2 "pi --model " +``` + +## Avoid these patterns + +Do not pile every command into the current pane. + +Do not use raw key injection for command submission when `pane run` is available. + +Do not wait for `agent-status` on a normal process that is not a coding agent. + +Do not change implementation direction without telling the user. diff --git a/docs/versions/0.5.11/website/src/content/docs/agents.mdx b/docs/versions/0.5.11/website/src/content/docs/agents.mdx new file mode 100644 index 00000000..e3d2bc0c --- /dev/null +++ b/docs/versions/0.5.11/website/src/content/docs/agents.mdx @@ -0,0 +1,129 @@ +--- +title: Agents +description: See what Herdr can detect, how agent state works, and how integrations improve it. +--- + +Herdr is useful because it knows when agents are working, blocked, done, or idle. You can scan the sidebar instead of checking every pane manually. + +## Supported agents + +Automatic detection works out of the box for common coding agents. + +| Agent | Idle / done | Working | Blocked | +| --- | --- | --- | --- | +| Pi | yes | yes | partial | +| Claude Code | yes | yes | yes | +| Codex | yes | yes | yes | +| Droid | yes | yes | yes | +| Amp | yes | yes | yes | +| OpenCode | yes | yes | yes | +| Grok CLI | yes | yes | yes | +| Hermes Agent | yes | yes | yes | +| GitHub Copilot CLI | yes | yes | yes | + +Detected but less thoroughly tested: Gemini CLI, Cursor Agent, Cline, and Kimi. + +Unsupported agents still run normally as terminal processes. They just may not get rich state unless you add an integration or report state over the socket API. + +## How detection works + +Herdr combines three signals: + +1. foreground process detection +2. terminal output heuristics +3. integration state reports + +Process detection tells Herdr which pane owns an agent. Heuristics infer state when no hook is available. Integrations provide the most precise semantic state. + +## State rollups + +The sidebar rolls state upward. + +A blocked agent makes its pane, tab, and workspace look blocked. A working agent makes the workspace look active. A done agent stays visible until you view it. + +This lets you scan many projects quickly. + +## Direct integrations + +Install integrations for agents that expose hooks or plugins: + +```bash +herdr integration install pi +herdr integration install claude +herdr integration install codex +herdr integration install opencode +herdr integration install hermes +``` + +Check installed integration versions: + +```bash +herdr integration status +``` + +Show only outdated integrations: + +```bash +herdr integration status --outdated-only +``` + +## Custom agent labels + +You can rename an agent target for display: + +```bash +herdr agent rename 1-1 reviewer +herdr agent rename reviewer --clear +``` + +Targets accept terminal IDs, unique agent names, detected or reported agent labels, and legacy pane IDs. + +## Custom status labels + +Integrations can report a visual status label without changing semantic state. + +```bash +herdr pane report-agent 1-1 \ + --source custom:indexer \ + --agent docs-bot \ + --state working \ + --custom-status indexing +``` + +`state` controls waits, notifications, and rollups. `custom-status` is only display text. + +## Start agents from the CLI + +Use `herdr agent ...` commands when you want a terminal to be treated as an agent target. Agent targets show up in `agent list`, can be read or sent input by agent name, can be waited on by agent state, and can be directly attached. + +Spawn an agent into Herdr from a script: + +```bash +herdr agent start reviewer --cwd ~/project --split right -- pi +``` + +You can place that agent in a specific workspace or tab: + +```bash +herdr agent start docs --workspace 1 --tab 1-1 -- claude +``` + +Use `herdr pane ...` commands for ordinary terminals, servers, tests, shells, and low-level terminal input. For example, use `pane split` and `pane run` for `cargo test`, not `agent start`, unless that terminal is intentionally being treated as an agent target. + +## Attach directly to an agent + +Attach your current terminal to one agent terminal instead of the full Herdr UI: + +```bash +herdr agent attach reviewer +``` + +Detach with `ctrl+b q`. Send a literal `ctrl+b` with `ctrl+b ctrl+b`. + +Use `--takeover` if another direct attach client already owns input: + +```bash +herdr agent attach reviewer --takeover +``` + +Use `herdr terminal attach ` when you want the same direct attach behavior for a non-agent terminal. diff --git a/docs/versions/0.5.11/website/src/content/docs/cli-reference.mdx b/docs/versions/0.5.11/website/src/content/docs/cli-reference.mdx new file mode 100644 index 00000000..57f495c1 --- /dev/null +++ b/docs/versions/0.5.11/website/src/content/docs/cli-reference.mdx @@ -0,0 +1,192 @@ +--- +title: CLI reference +description: Herdr commands for sessions, workspaces, tabs, panes, agents, waits, integrations, and status. +--- + +Herdr’s CLI talks to the running server over the same local socket API used by integrations and agents. + +Most commands print JSON responses. Use them from scripts when you want deterministic automation. + +## Launch and status + +```bash +herdr # launch or attach to the default session +herdr --session work # launch or attach to a named session +herdr --remote workbox # attach through SSH +herdr --no-session # single-process escape hatch +herdr --default-config # print default config +herdr --version # print version +``` + +Status commands: + +```bash +herdr status +herdr status server +herdr status client +``` + +## Server + +```bash +herdr server stop +herdr server reload-config +``` + +`reload-config` applies reloadable settings without restarting panes. + +## Sessions + +```bash +herdr session list [--json] +herdr session attach +herdr session stop [--json] +herdr session delete [--json] +``` + +Use `default` as the session name when you need to stop the default session explicitly. + +## Workspaces + +```bash +herdr workspace list +herdr workspace create [--cwd PATH] [--label TEXT] [--focus] [--no-focus] +herdr workspace get +herdr workspace focus +herdr workspace rename