@keelcode-ai/keelcode 0.1.5 → 0.1.6-darwin-x64

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/bin/keelcode ADDED
Binary file
package/bin/rg ADDED
Binary file
package/package.json CHANGED
@@ -1,49 +1,21 @@
1
1
  {
2
2
  "name": "@keelcode-ai/keelcode",
3
- "version": "0.1.5",
4
- "description": "The hosted Keelcode coding agent CLI.",
5
- "type": "commonjs",
3
+ "version": "0.1.6-darwin-x64",
4
+ "description": "Native Keelcode executable for darwin-x64. Install the keelcode package instead.",
6
5
  "license": "SEE LICENSE IN LICENSE",
7
6
  "homepage": "https://keelcode.ai",
8
7
  "publishConfig": {
9
8
  "access": "public"
10
9
  },
11
- "bin": {
12
- "keelcode": "bin/keelcode.cjs",
13
- "kc": "bin/kc.cjs",
14
- "kcode": "bin/kcode.cjs",
15
- "keel": "bin/keel.cjs"
16
- },
17
- "files": [
18
- "bin/keelcode.cjs",
19
- "bin/kc.cjs",
20
- "bin/kcode.cjs",
21
- "bin/keel.cjs",
22
- "README.md",
23
- "LICENSE",
24
- "CHANGELOG.md",
25
- "SECURITY.md"
10
+ "os": [
11
+ "darwin"
26
12
  ],
27
- "engines": {
28
- "bun": ">=1.3.14"
29
- },
30
- "keywords": [
31
- "cli",
32
- "agent",
33
- "ai",
34
- "hosted-ai",
35
- "coding-agent",
36
- "tui",
37
- "ink"
13
+ "cpu": [
14
+ "x64"
38
15
  ],
39
- "optionalDependencies": {
40
- "@keelcode-ai/keelcode-darwin-arm64": "npm:@keelcode-ai/keelcode@0.1.5-darwin-arm64",
41
- "@keelcode-ai/keelcode-darwin-x64": "npm:@keelcode-ai/keelcode@0.1.5-darwin-x64",
42
- "@keelcode-ai/keelcode-linux-arm64": "npm:@keelcode-ai/keelcode@0.1.5-linux-arm64",
43
- "@keelcode-ai/keelcode-linux-arm64-musl": "npm:@keelcode-ai/keelcode@0.1.5-linux-arm64-musl",
44
- "@keelcode-ai/keelcode-linux-x64": "npm:@keelcode-ai/keelcode@0.1.5-linux-x64",
45
- "@keelcode-ai/keelcode-linux-x64-musl": "npm:@keelcode-ai/keelcode@0.1.5-linux-x64-musl",
46
- "@keelcode-ai/keelcode-win32-arm64": "npm:@keelcode-ai/keelcode@0.1.5-win32-arm64",
47
- "@keelcode-ai/keelcode-win32-x64": "npm:@keelcode-ai/keelcode@0.1.5-win32-x64"
48
- }
16
+ "files": [
17
+ "bin/keelcode",
18
+ "bin/rg",
19
+ "LICENSE"
20
+ ]
49
21
  }
package/CHANGELOG.md DELETED
@@ -1,95 +0,0 @@
1
- # Changelog
2
-
3
- All notable changes to Keelcode will be documented in this file.
4
-
5
- The format is based on Keep a Changelog, and this project follows Semantic
6
- Versioning.
7
-
8
- ## [Unreleased]
9
-
10
- ## [0.1.5] - 2026-07-20
11
-
12
- ### Fixed
13
-
14
- - Make the trusted project settings path test portable across Windows and POSIX CI runners.
15
-
16
- ## [0.1.4] - 2026-07-20
17
-
18
- ### Added
19
-
20
- - Add `kc`, `kcode`, and `keel` as packaged aliases for the `keelcode` command.
21
- - Add safe custom command aliases with `keelcode alias setup|add|list|remove`.
22
- - Show client-observed TTFT and provider-token TPS in interactive and headless
23
- output without mixing tool time into model throughput; keep interactive
24
- context and performance telemetry immediately above the input box.
25
- - Make the CLI hosted-only: `keelcode login` now owns the API origin and bearer
26
- session, while customer provider keys, custom endpoints, and `ANTHROPIC_*`
27
- transport configuration are ignored.
28
- - Add `/ship`, an objective-bound deliverable workflow whose runtime withholds
29
- completion until a persisted passing `Verify` receipt, a read-only final
30
- review, the cited receipt ID, and a stabilized Git fingerprint all agree.
31
- - Discover layered `AGENTS.md` and `KEELCODE.md` instructions from the Git root
32
- to the active directory with source provenance and bounded, symlink-safe reads.
33
- - Add stable `json` and streaming `jsonl` headless output formats with explicit
34
- terminal outcomes and automation-friendly exit codes.
35
- - Add lease-checked detached Git worktree primitives for repository-state
36
- isolation without claiming operating-system sandboxing.
37
- - Add standalone `proof list/show` and `worktree create/status/cleanup` commands
38
- so automation can inspect receipts and manage isolated runs without an API key.
39
- - Add an opt-in-aware World Cup match surface with a startup Match Centre,
40
- compact in-session scores, scorer-specific goal takeovers, and `/football`
41
- controls. Live provider traffic stays in the Keelcode backend.
42
-
43
- ### Security
44
-
45
- - Treat checked-in `.keelcode/settings.json` and `.keelcode/settings.local.json`
46
- as untrusted input: repositories can add restrictions and presentation
47
- preferences, but cannot enable prompt-free modes, auto-allow tools, inject
48
- environment variables, or launch MCP processes.
49
- - Store explicitly approved per-project MCP and allow settings in an owner-only
50
- directory outside the checkout, and pass MCP processes a minimal environment
51
- instead of every credential held by the CLI.
52
- - Require an explicit permission decision for filesystem access outside the
53
- active workspace, including symbolic-link escapes, and make delegated agents
54
- inherit the parent permission gate and deny rules.
55
- - Pin each WebFetch HTTPS connection to the public address that was validated,
56
- revalidating every redirect to prevent DNS-rebinding SSRF.
57
- - Require approval for Git commands that write through `--output` or `-o`.
58
- - Redact and cap persisted verification output, store receipts and worktree
59
- leases with owner-only POSIX permissions, and bound gate count and execution time.
60
- - Make Verify approvals fully scrollable and auditable, hard-limit observed
61
- output, show exact executable command text, reject destructive checks and
62
- common background syntax, detect residual children, and anchor local receipt
63
- bytes per ship run.
64
- - Hash actual tracked/untracked worktree bytes and submodules independently of
65
- Git stat-cache, filter, assume-unchanged, and skip-worktree behavior; isolate
66
- Git subprocesses from ambient `GIT_*` injection.
67
- - Reject symlinked private receipt roots and revalidate directory/file identity
68
- across receipt publication and reads.
69
- - Block WebFetch access to unsafe URL schemes, credentials, local/private
70
- networks, and unsafe redirect targets.
71
- - Store user transcripts, mission artifacts, caches, and crash logs with
72
- owner-only POSIX permissions.
73
- - Clarify that `bypassPermissions` is an explicit no-prompt mode while deny
74
- rules and tool hard denials remain enforced.
75
-
76
- ### Fixed
77
-
78
- - Keep installation and normal startup independent of Nerd Fonts; failed,
79
- skipped, unsupported, and manual-only setup paths now remain on safe Unicode.
80
- - Extract the optional pinned Nerd Font archive inside Keelcode instead of
81
- depending on `tar` or PowerShell, and verify its SHA-256 before installation.
82
- - Reject Windows UNC paths before POSIX normalization can hide their form.
83
- - Run the npm launcher with Bun so globally installed commands work on Bun-only
84
- machines without a `node` executable.
85
- - Avoid misclassifying an already-exiting Windows verification child as a
86
- residual background process when no process tree was actually terminated.
87
-
88
- ### Build
89
-
90
- - Standardize development, security auditing, packing, and CI on Bun.
91
- - Replace the unpublished JavaScript npm artifact with a small launcher and
92
- exact platform-suffixed versions of the single `keelcode` package name for
93
- macOS, Linux, and Windows on x64/arm64.
94
- - Fail release packing when source files, source maps, private metadata,
95
- upstream endpoints, or secret-shaped credentials appear in an npm artifact.
package/README.md DELETED
@@ -1,226 +0,0 @@
1
- # keelcode
2
-
3
- Keelcode is a hosted coding agent for your terminal. It can inspect a project,
4
- edit files, run commands, search the web, use MCP servers, and verify its work.
5
-
6
- ## Install
7
-
8
- Keelcode requires Bun 1.3.14 or newer. It does not require Node.js. Install it
9
- globally with Bun:
10
-
11
- ```bash
12
- bun add --global @keelcode-ai/keelcode
13
- ```
14
-
15
- The package provides four equivalent commands:
16
-
17
- ```text
18
- keelcode
19
- kc
20
- kcode
21
- keel
22
- ```
23
-
24
- To add your own command name after installation, run the guided setup or add
25
- one or more aliases directly:
26
-
27
- ```bash
28
- keelcode alias setup
29
- keelcode alias add mycode kk
30
- keelcode alias list
31
- keelcode alias remove kk
32
- ```
33
-
34
- Custom aliases are created beside the package-manager shims. Keelcode refuses
35
- to overwrite an existing command and never edits shell startup files. Package
36
- installation stays non-interactive so it remains reliable in terminals, CI,
37
- containers, and package managers that disable lifecycle scripts.
38
-
39
- Fonts are never downloaded and terminal settings are never edited during
40
- installation or normal startup. Keelcode defaults to font-independent Unicode,
41
- and falls back to ASCII for clearly limited terminals. Rich Nerd Font icons are
42
- an optional upgrade through `keelcode setup`; a failed or skipped setup keeps
43
- the safe icon set enabled.
44
-
45
- The `@keelcode-ai/keelcode` npm package is a small launcher that installs the matching
46
- platform-suffixed version of that same package name for the current operating
47
- system, CPU, and Linux libc. Keelcode's
48
- application JavaScript, TypeScript, source maps, tests, and build configuration
49
- are not included in the public package.
50
-
51
- ## Sign in and start
52
-
53
- ```bash
54
- keelcode login
55
- keelcode
56
- ```
57
-
58
- If the machine cannot open a browser:
59
-
60
- ```bash
61
- keelcode login --no-browser
62
- ```
63
-
64
- Keelcode will also start sign-in automatically when an interactive session has
65
- no usable account. Authentication uses a short-lived device approval; provider
66
- credentials are never stored in the CLI.
67
-
68
- Useful account commands:
69
-
70
- ```bash
71
- keelcode whoami
72
- keelcode usage
73
- keelcode logout
74
- ```
75
-
76
- ## Everyday use
77
-
78
- Start in the current project:
79
-
80
- ```bash
81
- keelcode
82
- ```
83
-
84
- Run one prompt without opening the TUI:
85
-
86
- ```bash
87
- keelcode -p "find and fix the failing test"
88
- git diff | keelcode -p "review this diff"
89
- ```
90
-
91
- Resume work:
92
-
93
- ```bash
94
- keelcode -c
95
- keelcode sessions
96
- keelcode --resume 2
97
- ```
98
-
99
- Choose a model at launch:
100
-
101
- ```bash
102
- keelcode --model <model-alias>
103
- ```
104
-
105
- Inside the TUI, use `/models` to open the current model picker and `/usage` to
106
- see the remaining hosted allowance. Run `/help` for the complete command list.
107
- The footer reports client-observed `ttft` and `tps` for the latest model turn.
108
- TTFT includes network and gateway latency; TPS uses provider-reported output
109
- tokens and excludes tool execution. A dash is shown when the stream does not
110
- contain enough timing or usage information for an honest measurement.
111
-
112
- Measure local launcher startup:
113
-
114
- ```bash
115
- keelcode bench
116
- keelcode bench --json
117
- ```
118
-
119
- The benchmark runs the installed launcher repeatedly, reports median/p90/min/max
120
- latency, and is useful for comparing terminals, package managers, and releases.
121
-
122
- ## Common options
123
-
124
- ```text
125
- -m, --model <alias> choose a Keelcode model
126
- --permission-mode <m> default | plan | acceptEdits | bypassPermissions
127
- --yolo bypass permission prompts in trusted environments
128
- --cwd <dir> set the working directory
129
- --icons <set> unicode | nerd | ascii | auto
130
- --no-alt-screen keep output in the main terminal buffer
131
- -c, --continue resume the newest session in this directory
132
- --resume [id] resume by id/index; no argument lists sessions
133
- -p, --print [prompt] run one headless prompt
134
- --output-format <f> text | json | jsonl
135
- -h, --help show help
136
- -v, --version show the installed version
137
- ```
138
-
139
- `bypassPermissions` and `--yolo` remove confirmation prompts for operations
140
- inside the workspace. Crossing the workspace boundary still requires explicit
141
- approval and fails closed in headless mode.
142
-
143
- ## Configuration
144
-
145
- Settings merge in this order, with later files winning:
146
-
147
- 1. `~/.keelcode/settings.json`
148
- 2. `<project>/.keelcode/settings.json` and `settings.local.json` (sanitized,
149
- capability-reducing fields only)
150
- 3. trusted per-project overrides under `~/.keelcode/projects/<workspace-hash>/`
151
- 4. command-line flags
152
-
153
- Example project configuration:
154
-
155
- ```json
156
- {
157
- "model": "<model-alias>",
158
- "permissionMode": "default",
159
- "maxTurns": 100,
160
- "timeoutMs": 600000,
161
- "permissions": {
162
- "ask": ["Bash", "Write", "Edit"],
163
- "deny": ["Write(/etc/**)"]
164
- }
165
- }
166
- ```
167
-
168
- Committed or in-tree settings cannot enable MCP processes, inject environment
169
- variables, add allow rules, select `acceptEdits`/`bypassPermissions`, or define
170
- unknown future capabilities. Explicit per-project choices made through the CLI
171
- are stored outside the repository. Keelcode does not support bring-your-own-provider keys.
172
-
173
- ## MCP and skills
174
-
175
- Inspect extension health:
176
-
177
- ```bash
178
- keelcode doctor
179
- keelcode mcp list
180
- keelcode skills list
181
- keelcode import list
182
- ```
183
-
184
- Use `keelcode mcp --help` and `keelcode skills --help` for management commands.
185
- MCP tools pass through the same permission checks as built-in tools.
186
-
187
- ## Automation
188
-
189
- For scripts and CI, prefer structured headless output:
190
-
191
- ```bash
192
- keelcode -p "run the tests and summarize failures" --output-format json
193
- keelcode -p "review this repository" --output-format jsonl
194
- ```
195
-
196
- Human progress is written to stderr. Machine-readable results are written to
197
- stdout, so redirecting stdout does not mix logs into the protocol.
198
- Model performance is written to stderr in text mode and included as structured
199
- `performance` data in JSON/JSONL output.
200
-
201
- ## Local data and privacy
202
-
203
- Keelcode stores account sessions, settings, conversations, caches, and local
204
- receipts under `~/.keelcode`. Sensitive state uses owner-only permissions on
205
- supported POSIX systems.
206
-
207
- Anonymous product analytics are opt-in and can be controlled at any time:
208
-
209
- ```bash
210
- keelcode telemetry status
211
- keelcode telemetry enable
212
- keelcode telemetry disable
213
- ```
214
-
215
- Do not paste production secrets into prompts or commit `.keelcode` personal
216
- state to a repository.
217
-
218
- ## Security
219
-
220
- Report suspected vulnerabilities privately to `security@keelcode.ai`. Do not
221
- include real credentials or unrelated private data in a report.
222
-
223
- ## License
224
-
225
- Keelcode is proprietary software. Installation and use are governed by the
226
- license included with this package and the applicable Keelcode service terms.
package/SECURITY.md DELETED
@@ -1,23 +0,0 @@
1
- # Security Policy
2
-
3
- ## Supported versions
4
-
5
- Security fixes are provided for the latest published version of Keelcode.
6
-
7
- ## Reporting a vulnerability
8
-
9
- Please do not disclose an unpatched vulnerability publicly. Email
10
- `security@keelcode.ai` with the affected version, reproduction steps, impact,
11
- and any suggested mitigation.
12
-
13
- Avoid including real API keys, proprietary source code, or other sensitive data
14
- in a report. We will acknowledge a complete report as soon as practical and
15
- coordinate disclosure after a fix is available.
16
-
17
- ## Local data
18
-
19
- Keelcode persists conversations, mission records, downloaded skills, model
20
- metadata, and crash diagnostics under `~/.keelcode` by default. On POSIX systems,
21
- Keelcode creates its private state directories with mode `0700` and sensitive
22
- files with mode `0600`. Users remain responsible for securing backups and any
23
- custom path supplied through `KEELCODE_CONFIG_DIR`.