Skip to content
This repository was archived by the owner on Feb 25, 2026. It is now read-only.

docs: explain GitHub release asset naming in README #598

Closed
Olusammytee wants to merge 2 commits into from
Closed

docs: explain GitHub release asset naming in README #598

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
91d7aa4
docs: clarify GitHub release asset naming in README
Olusammytee Feb 21, 2026
c18e7a0
docs: clarify x64_baseline wording in release asset guide
Olusammytee Feb 22, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 20 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -59,6 +59,26 @@ npx @kilocode/cli

Then run `kilo` in any project directory to start.

### Install from GitHub Releases (Optional)

If you prefer downloading a binary from the [Releases page](https://github.com/Kilo-Org/kilo/releases), use this quick guide:

- `kilo-<os>-<arch>.zip` is the CLI binary for your OS and CPU architecture.
Copy link

Copilot AI Feb 22, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The release archives are not always .zip. The build script produces .tar.gz archives for Linux targets (and .zip for non-Linux), so this line will mislead Linux users. Consider documenting the extension as platform-dependent (e.g., .zip on macOS/Windows, .tar.gz on Linux).

Copilot uses AI. Check for mistakes.
- `darwin` means macOS.
- `x64` is standard 64-bit Intel/AMD CPUs.
- `x64_baseline` is a compatibility build for older x64 CPUs that may not support newer instruction sets.
- `arm64` is Apple Silicon (M1/M2/M3) or ARM-based Linux/Windows.
Copy link
Contributor

@kilo-code-bot kilo-code-bot bot Feb 22, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

WARNING: The build matrix does not include a Windows ARM64 target (win32 + arm64 is absent from allTargets in build.ts). Mentioning "ARM-based … Windows" here will confuse users looking for a kilo-windows-arm64 binary that doesn't exist.

Suggested change
- `arm64` is Apple Silicon (M1/M2/M3) or ARM-based Linux/Windows.
- `arm64` is Apple Silicon (M1/M2/M3) or ARM-based Linux.

- `kilo-vscode-*.vsix` is the VS Code extension package (not the CLI binary).
- `Source code` archives are for building from source, not normal installation.

For most users:

- **Windows (most PCs):** `kilo-windows-x64.zip`
- **Windows on ARM:** `kilo-windows-arm64.zip`
- **macOS Apple Silicon:** `kilo-darwin-arm64.zip`
- **macOS Intel:** `kilo-darwin-x64.zip`
- **Linux x64:** `kilo-linux-x64.zip`
Comment on lines 66 to 80
Copy link

Copilot AI Feb 22, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These example filenames don’t match what the release process produces: Linux artifacts are uploaded as .tar.gz (e.g., kilo-linux-x64.tar.gz), and there is no Windows ARM64 build target in the current CLI build matrix. Please update the examples to reflect the actual published assets (and, if Windows ARM isn’t supported, say so explicitly).

Suggested change
- `kilo-<os>-<arch>.zip` is the CLI binary for your OS and CPU architecture.
- `darwin` means macOS.
- `x64` is standard 64-bit Intel/AMD CPUs.
- `x64_baseline` is a compatibility build for older CPUs that may not support newer instruction sets.
- `arm64` is Apple Silicon (M1/M2/M3) or ARM-based Linux/Windows.
- `kilo-vscode-*.vsix` is the VS Code extension package (not the CLI binary).
- `Source code` archives are for building from source, not normal installation.
For most users:
- **Windows (most PCs):** `kilo-windows-x64.zip`
- **Windows on ARM:** `kilo-windows-arm64.zip`
- **macOS Apple Silicon:** `kilo-darwin-arm64.zip`
- **macOS Intel:** `kilo-darwin-x64.zip`
- **Linux x64:** `kilo-linux-x64.zip`
- `kilo-<os>-<arch>.zip` is the CLI binary for your OS and CPU architecture on Windows and macOS. On Linux, binaries are published as `kilo-<os>-<arch>.tar.gz`.
- `darwin` means macOS.
- `x64` is standard 64-bit Intel/AMD CPUs.
- `x64_baseline` is a compatibility build for older CPUs that may not support newer instruction sets.
- `arm64` is Apple Silicon (M1/M2/M3) or ARM-based Linux.
- `kilo-vscode-*.vsix` is the VS Code extension package (not the CLI binary).
- `Source code` archives are for building from source, not normal installation.
For most users:
- **Windows (most PCs):** `kilo-windows-x64.zip`
- **Windows on ARM:** Native Windows ARM builds are not currently published. If supported by your system, you may run the x64 build under emulation.
- **macOS Apple Silicon:** `kilo-darwin-arm64.zip`
- **macOS Intel:** `kilo-darwin-x64.zip`
- **Linux x64:** `kilo-linux-x64.tar.gz`

Copilot uses AI. Check for mistakes.

### Autonomous Mode (CI/CD)

Use the `--auto` flag with `kilo run` to enable fully autonomous operation without user interaction. This is ideal for CI/CD pipelines and automated workflows:
Expand Down
Loading