Repository navigation
docs(levelcode): the browser edition has a terminal (LevelCode Shell) — say what it is and is not - #99
Merged
Conversation
… and the agent runs commands in it; say what it is and is not The page and docs/browser.mdx said there was no terminal and that the agent does not run shell commands. Both are now false. LevelCode Shell is bash over the open files with about eighty built-in commands; it does not run programs (no Node, npm, git, Python), has no network and no background jobs. What stays in the Mac app is the list of what a shell cannot do without a machine.
Contributor
There was a problem hiding this comment.
🟡 Changes recommended
The cancellation guidance promises unchanged files even when interrupted file application can leave partial changes.
1 open finding
What changed in this PR
Updates browser-edition copy to describe LevelCode Shell and distinguish file commands from capabilities reserved for the Mac app.
Changes:
- Replaces outdated “no terminal” claims.
- Documents shell usage, restrictions, and cancellation.
- Updates troubleshooting and Mac-app guidance.
| File | Description |
|---|---|
| src/levelcode/pages/WebEditorPage.tsx | Adds shell capabilities and revises Mac-only features. |
| src/levelcode/docs/browser.mdx | Documents shell usage, limits, and troubleshooting. |
🧠 Review effort: Balanced
💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.
| - **Open it** from the Command Palette with *LevelCode Shell: New Terminal*, or from the Terminal panel. | ||
| - **It does not run programs.** There is no Node, npm, git, Python or compiler in it, and no network. `npm test` answers "command not found". Use it to read, search and reshape files: count TODOs, rename a batch of files, run a `sed` over several files, look at a JSON file with `jq`. | ||
| - **The agent uses it too.** When the agent runs a command, it runs here. Files it changes are offered for Keep or Undo like any other edit. A command that would touch repository metadata or tool settings (`.git`, `.vscode`, `.github/workflows`, `AGENTS.md` and similar), a file that is not plain text, or a file you have unsaved changes in, is refused as a whole, and nothing from that command is applied. | ||
| - **Stop it with Ctrl+C.** A command that is stopped, runs out of time or hits a limit changes nothing. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
The browser edition now has a terminal: say what it is and is not
Stacked on #98. Draft — do not merge before levelcodeai/levelcode#107 is. The page and
docs/browser.mdxsaid"no terminal, and the agent does not run shell commands". With LevelCode Shell that is no longer true, and it must not
be replaced by a claim that is bigger than the product.
What the copy now says (one place per fact, as before: the
FACTSblock ofWebEditorPage.tsxand the docs page):more) over the files you have open. The agent runs its commands there too, and what they change is offered for Keep
or Undo.
npm testanswers"command not found".
background commands and dev servers, MCP servers that start local processes, installing extensions.
that a command touching repository metadata, a non-text file or a file with unsaved changes is refused whole, and
that Ctrl+C stops a command and changes nothing.
No new numbers, no benchmark, no comparison. Checked:
tsc -b,eslinton the page,vite build(the MDX compiles).