Repository navigation
Open
Description
Why
These features are covered by unit and flow tests but have never been used by a person in a real terminal or against real services. Each needs a few minutes. Report anything odd here, or open a bug.
Build first: cargo build --release, then use target/release/incode. Settings go in ~/.incode/admin.json.
Terminal
- Notifications (
notify:auto|bell|desktop|off,notify_after_secs,notify_command). Run a turn longer than 10 s, then leave a permission question open. On Windows, check that the toast (BurntToast or WinRT) appears; macOS usesosascriptand Linuxnotify-send. - Status line (
statusline_command): a script that reads the JSON on stdin and prints one line. Check it renders, and that a slow script (over 1.5 s) keeps the last good line. -
/vimand"editing_mode": "vi":Esc,h l w b e 0 ^ $ x X D C s S dd cc i a I A j k, Enter from normal mode. -
~/.incode/keybindings.toml, e.g."ctrl-l" = "clear-line". -
/cost: the numbers look right for your model, and an unpriced model says so.
Commands and review
- A custom command:
.incode/commands/test.mdwith$ARGUMENTS,$1, an@src/file.rsinclude, andallowed-tools: Read. Run/test something, then check that a write is refused on the Claude/API route. -
incode reviewon a branch with a change. It runs read-only (VS Code extension, Python and TypeScript SDKs, local test runner, and fixes from the first real CI run #16); check that nothing is written. -
/compacton the API route in a long conversation.
MCP and plugins
- A project
.mcp.jsonserver: first-use approval in the REPL, thenincode mcp list. -
incode mcp login <name>against a real remote server that needs OAuth. Check the browser opens on each OS (Windows usescmd /c startwith&escaped as^&; macOSopen), then use a tool, thenincode mcp logout <name>. Logout only forgets the token locally; there is no revocation call. (Windows verified 2026-11-13 against GitHub's remote MCP server; macOSopennot run.) -
incode plugin add <git url>, thenincode plugin update. On a failed fetch the installed copy must stay.
Sandbox
- The sbx engine with an allowlist:
Then have the model run
{ "sandbox_engine": "sbx", "sandbox_allow_hosts": ["crates.io", "static.crates.io"] }curl https://crates.io(allowed) andcurl https://example.com(refused). - RenderPdf on Ubuntu 23.10+: if the browser can't build its own sandbox, the error says so and what to do (VS Code extension, Python and TypeScript SDKs, local test runner, and fixes from the first real CI run #16).
Known small gaps (fix if they bite)
- An
Agentsub-agent runs under its own definition's tools, not the custom command'sallowed-tools. - The
allowed-toolsparse-warning and not-enforced notices appear after the turn, not before. - A custom command's
modelis only named in the REPL, not switched to. - MCP OAuth: no token revocation on logout;
client_secret_basicisn't supported; login proceeds when the server's metadata lists no PKCE methods (lenient). - MCP: a server that only speaks legacy SSE won't connect (
sseis tried over Streamable HTTP).
Generated by Claude Code
Metadata
Metadata
Assignees
Labels
No labels
Activity
blockmandev commentedon Oct 24, 2026
Tried by hand on Windows with the official v0.1.0
Each check ran in a scratch folder, with a control where one made sense.
incode plugin add <git url>, thenincode plugin updateupdatesaid1.0.0 → 1.1.0. With the source deleted,updatefailed and the installed 1.1.0 stayed, with no half-finished folder left behind.allowed-tools: Read(Claude Code route)allowed-toolsdid write it. The@src/file.rsinclude reached the model.$ARGUMENTS/$1were not echoed back by the model; they are covered by the unit testarguments_are_substituted.incode reviewon a change.mcp.jsonserver,incode mcp list/approveneeds approval, thenapproved. Changing the server's command asked for approval again. The first-use prompt inside the interactive terminal is still to try.Bug found and fixed: #67 (merged)
A file saved with a byte-order mark, as Windows PowerShell 5.1 and some editors save it, broke incode's readers of hand-written files:
nameis missing".allowed-toolswas silently not applied.admin.json,mcp.jsonand the project's permission settings were refused.One shared reader now handles it. There are 8 tests for it, and all 8 fail when the fix is switched off.
Still for the owner (needs a real terminal, a browser login, or admin)
/vim, typing withkeybindings.toml,/cost./compact(needs an API key).incode mcp loginagainst a real OAuth server.sbx setup-windowsas admin first (same step as insbx on Windows: Git Bash / msys can't start natively (error 5); fix with a private object namespace per run #38/insbx: a ready-made policy for running Claude Code (and what the Windows offline account must read) #40).blockmandev commentedon Oct 24, 2026
Terminal checks, now done by the agent in a real (pseudo) console. The shell the agent runs in is not a terminal, so the REPL was driven through Windows' pseudo-console (ConPTY): a real console from incode's side, with keys typed and the screen read back. The official build was used, with a scratch settings folder.
/vim/"editing_mode": "vi": pass. The input line, frame by frame:hello worldtyped;0xgivesello world;wDgivesello;ddclears the line;ireturns to insert mode;/quitexits ("Goodbye!").(
dwdoes nothing, as designed: onlyddandcccombine with an operator.)Next with the same harness: keybindings (
ctrl-l= clear-line), the status line (rendering, and a slow script keeping the last line), notifications (bell or a notify command after a long turn),/cost.Still for the owner:
sbx setup-windowsas admin.blockmandev commentedon Nov 13, 2026
sbx allowlist (now
insbx): checked on Windows natively, with theinsbx-offlineaccount set up. Under--net proxywith onlyapi.anthropic.comallowed, Claude Code answered. Every other host it tried was refused and logged:api.githubcopilot.com,api.greptile.com,mcp.trendkia.com,mcp-proxy.anthropic.com, and Datadog telemetry. With no host allowed,api.anthropic.comwas refused until the wall limit. A write outside the project failed withEPERM. Details are in the PR for #40.blockmandev commentedon Nov 13, 2026
RenderPdf on Ubuntu 23.10+: verified on GitHub's
ubuntu-latest(Ubuntu 24.04), in PR #91's new CI step, which shows the output on every run. The runner's Edge can't build its own sandbox, and incode says so and what to do instead of printing nothing: "the browser exited with signal 6 (SIGABRT) and printed no PDF; it could not start its own sandbox on this machine (a setuid sandbox helper that is not installed as root, or unprivileged user namespaces turned off, as Ubuntu 23.10 and later do by default); fix the browser's sandbox or setpdf_rendererto another program". The headless-browser tests skip there because none is installed.ci: RenderPdf on the Linux runner with its output shown (#22) (#91)
blockmandev commentedon Nov 13, 2026
Terminal checks, round two, by the agent in a real (pseudo) console. Same method as the
/vimcheck: incode was spawned in a Windows pseudo-console (ConPTY, via pywinpty), keys were typed, and the screen was read back through a terminal emulator. Build: currentorigin/main(1c7ae5e), release, with a scratch settings folder (INCODE_DIR), so the real settings were not touched. The agent was Claude Code with the installed CLI; the only model calls were two one-word turns.keybindings.toml)/costnotify = bellandnotify_command; the Windows toast needs your eyes/compactKey bindings
keybindings.tomlwith"ctrl-l" = "clear-line". The input row of the box, frame by frame:hello world:│ hello world│followed by blanks, so the line is emptyagainafterwards:│ again, so the box still works.Control, with no
keybindings.toml: Ctrl-L turnshello worldintohello worldl.Small bug found: an unbound Ctrl or Alt letter is typed into the box as the plain letter. In
Footer::on_key(src/cli/footer.rs), theKeyCode::Char(ch)arm insertschwhatever the modifiers are. Onlyc d u k a e ware handled before it, so Ctrl-L, Ctrl-B, Ctrl-F and the Alt-letters all insert a letter. A binding (as above) fixes it per key. A fix would be to skip the insert when Ctrl or Alt is held and nothing handled the key. I did not touch the repo.Status line
statusline_commandis a.cmdscript that printsSL-run-<n> on <cwd>and logs each run; it sleeps 5 s when aslow.flagfile exists.╭─ SL-run-1 on D:\...\conpty\ws ───…╮(the script log saysrun 1 fast)╭─ SL-run-2 on D:\...\conpty\ws ───…╮(logrun 2 fast), so it re-runs after a turn.slow.flagset, after turn 2: the rule still readsSL-run-2. The log hasrun 3 SLOW, so the script did run, was given up on at 1.5 s, and the last good line stayed./costBefore any turn:
--- Cost ---/No tokens reported yet this session.After one turn on the Claude Code agent:
claude-code: unpricedinput 2 output 7 cache write 20168 cache read 0Total: ~$0.0000 (1 model(s) unpriced, not included)Estimate from list prices (src/runtime/usage.rs PRICES); a subscription is billed differently.So an unpriced model says so and is never guessed. The numbers for a priced API model are not checked (that needs an API key).
Notifications
Settings:
"notify": "bell","notify_after_secs": 1, and anotify_commandthat appends%INCODE_EVENT% / %INCODE_MESSAGE%to a file. After each of the two turns (about 6 s each):done / Turn finished after 6s: two lines in total, matching the two turns;\x07) per turn: 1 after turn 1, 2 after turn 2./costand the status line ran between the turns and added nothing, so only turns trigger it. Still for the owner: seeing the visible Windows toast (notify = desktop), and the "agent stops to ask for permission" case./compactNo API key is set anywhere on this machine:
ANTHROPIC_API_KEY,ZAI_API_KEY,OPENROUTER_API_KEYandINCORD_KEY(the names inapi_models) are all unset in the process and user environment. On the Claude Code agent/compactanswers "The agent manages its own context and compacts it automatically. Use /clear to start a fresh session." That is the designed CLI-agent path, not the API route this item is about. It needs an API key.Still for the owner: the toast,
/compacton the API route (with a key), MCP OAuth login, and the first-use.mcp.jsonapproval prompt in the terminal.blockmandev commentedon Nov 13, 2026
incode mcp loginagainst a real OAuth server: passed on Windows (installedincode 0.1.0)Server: GitHub's remote MCP server (
https://api.githubcopilot.com/mcp/) in a project.mcp.json, using a hand-registered GitHub OAuth app (GitHub offers no dynamic client registration), withoauth.callback_port33418.incode mcp login github-oauth-test: the browser opened GitHub's Authorize page (PKCE S256,resourceset, the server's advertised scopes). After Authorize, the loopback callback was received and the command printedlogged in. Exit 0.incode mcp list:OAuth: logged in. Afterincode mcp approve, it showedapproved.incode -tcalledmcp__github-oauth-test__get_me, and GitHub returned the signed-in account. In-p read-onlythe same call is refused, as expected.incode mcp logout github-oauth-test:its tokens are forgotten.incode mcp listthen showsnot logged in.Not run: macOS
open. Item 19 is still unticked because approval went throughincode mcp approve, not the first-use prompt in the REPL.