Switches the Kilo JetBrains plugin between a pinned released CLI and a freshly built local CLI. Includes commands to clear old build artifacts, regenerate the local executable, and verify the selected setup with Gradle.
中文简介正在准备中。当前显示英语简介。
Use when pinning or unpinning the CLI version the Kilo JetBrains plugin uses, or fresh-regenerating the local repo CLI. Cleans all leftover CLI binaries and build artifacts in the current worktree so every operation starts from a fresh, artifact-free state.
安装前可以查看交给 AI 代理的指令内容。
Pin the Kilo JetBrains plugin to the latest released CLI, unpin it to use the local repo CLI, or fresh-regenerate the local CLI while unpinned. Every command first cleans all CLI/pin build artifacts and binaries in the current worktree so the result never carries state from a previous run.
Run all commands from the repository root of the worktree you want to affect. Paths are relative, so they resolve to the current worktree, not the main checkout.
The plugin's CLI behavior is governed by two independent values:
| Control | Location | Meaning |
|---|---|---|
| Pin mode | packages/kilo-jetbrains/gradle.properties -> kilo.cli.pinned | true = download the released CLI at build/connect time. false = build and bundle the local repo CLI. |
| Pinned version | packages/kilo-jetbrains/package.json -> version | Which GitHub CLI release is downloaded and generated from when pinned=true. |
"Pin to latest" means kilo.cli.pinned=true and package.json set to the latest
stable CLI release. "Unpin" means kilo.cli.pinned=false with a freshly built local CLI
bundled.
bun .kilo/skills/jetbrains-cli-pin/script/cli-pin.ts <command> [--no-verify]
| Command | Steps |
|---|---|
pin | Clean -> set kilo.cli.pinned=true -> remove the repo-CLI Bun path hint -> bump package.json to latest release (via set-pin.ts --latest, which validates release assets) -> verify with a cold gradlew clean typecheck. |
unpin | Clean -> set kilo.cli.pinned=false -> write the repo-CLI Bun path hint -> :backend:buildRepoCli (fresh CLI) -> :backend:stageRepoCli -> assert staged kilo-cli.zip -> verify with gradlew typecheck. |
regen | Fast dev loop while unpinned: refresh the repo-CLI Bun path hint -> rm -rf dist -> buildRepoCli -> stageRepoCli. Refuses to run unless kilo.cli.pinned=false. |
clean | Run the shared artifact clean only. |
--no-verify skips the gradle verification build (rewrites + clean only). Use it when
offline or without Java 21.
clean() runs ./gradlew clean plus targeted deletes. All paths are gitignored, so
tracked files are never touched. The clean removes the stale artifacts that otherwise
leak across a pin/unpin flip:
| Artifact | Path |
|---|---|
| Repo CLI binaries | packages/opencode/dist/ |
| Staged CLI archive | packages/kilo-jetbrains/backend/build/generated/kilo-cli-res/kilo-cli.zip |
| Generated props / checksums / OpenAPI client | packages/kilo-jetbrains/backend/build/generated/ |
| Compiled resources (bundled zip on classpath) | packages/kilo-jetbrains/backend/build/resources/ |
| CLI download cache | packages/kilo-jetbrains/backend/build/cli-cache/ |
The staged kilo-cli.zip is the nastiest leak: once it lands in backend/build/resources/main/
from an unpinned build, runtime prefers the bundled zip over downloading. A full clean is
the only reliable reset.
In repo CLI mode, Gradle's generateOpenApiSpec task runs the local CLI source through
bun run --conditions=browser ./src/index.ts generate. IDE-launched Gradle runs can have
a stripped PATH where bun isn't resolvable. The unpin/regen commands write an ignored, worktree-local hint:
packages/kilo-jetbrains/.gradle/kilo-cli-pin.properties
The file contains bun.path=<absolute path> and is consumed by backend/build.gradle.kts
for repo CLI tasks. pin removes it because pinned mode should not depend on local Bun.
--no-configuration-cache so the changed kilo.cli.pinned
value is re-read instead of served from the on-disk Gradle configuration cache.pin verification is a cold build: it downloads the pinned CLI release via
generateOpenApiSpec and needs network access plus Java 21. Use --no-verify offline.kilo.cli.pinned=false is dev-only and not releasable. Production Gradle builds,
script/build-version.sh, and the release scripts hard-fail on false -- run pin
before releasing./release-jetbrains command
(.kilo/command/release-jetbrains.md); this skill reuses its set-pin.ts and
pin-common.ts helpers from .kilo/skills/release-jetbrains/script/.jetbrains-dev skill (.kilo/skills/jetbrains-dev/SKILL.md).还没有评价。欢迎分享你的使用感受。
无需登录即可发表。欢迎分享使用感受、提问，或说明在哪些环境下无法运行。
还没有评论。来写第一条吧。
Creates charts from numerical data using the chart tool and Chart.js v4. Supports bars, lines, pies, scatter plots, and other formats to show comparisons, trends, proportions, and relationships, with options for dataset colors and mixed charts.
中文简介正在准备中。当前显示英语简介。
Develop TypeScript services and workflows with Effect v4 by checking its source and existing project examples. Guides data schemas, typed errors, explicit dependencies, and tests that follow the project's established patterns.
中文简介正在准备中。当前显示英语简介。
Create and manage GitHub issues for the Kilo VS Code extension or JetBrains plugin using gh, GitHub's command-line tool. Guides template selection, clear titles, required project board assignment, and authentication permissions.
中文简介正在准备中。当前显示英语简介。
Create and review SVG icons for IntelliJ New UI. Choose sizes by interface role, prepare matching light and dark versions, refine shapes and strokes, and place the assets in the plugin’s resource folders.
中文简介正在准备中。当前显示英语简介。
Create and review icons for Kilo’s VS Code extension and webviews, the extension’s embedded interface panels. Choose existing icons or suitable SVG assets, register them correctly, and check theme appearance and accessible button names.
中文简介正在准备中。当前显示英语简介。
Guides development across the Kilo JetBrains plugin’s shared, frontend, and backend modules. Explains remote calls between modules, UI thread rules, dependency packaging, and testing practices, including serialization failures that require checks in a running IDE.
中文简介正在准备中。当前显示英语简介。