Core workflow
Terminal & console
Every workspace has a real shell running in its worktree, plus a color-coded console that logs every git operation NeuralCode performs.
steve@MacBook-Pro fix-test-bug % npm run dev
> vite
VITE v7.0.4 ready in 412 ms
➜ Local: http://localhost:1420/
steve@MacBook-Pro fix-test-bug % _
The terminal#
The Terminaltab is a genuine pseudo-terminal (PTY) running your login shell, rooted in the workspace's worktree. Use it to run tests, start a dev server, inspect output, or run any command — exactly as you would in a normal terminal, but scoped to that branch.
| Capability | Detail |
|---|---|
| Real shell | Built on a native PTY via xterm.js — full ANSI colors, interactive programs, the works. |
| Auto-fit | The terminal resizes to the panel and keeps the backend PTY dimensions in sync. |
| Persistent | Switching to the Console tab keeps the shell session alive — it isn't torn down. |
The git console#
The Console tab is a live, color-coded log of every git operation NeuralCode runs on your behalf — commit, push, PR, merge. When you trigger one of those actions, the console opens automatically so you can watch it happen.
✓$ git add -Aok
✓$ git commitok
[code-agents/fix-test-bug 4ae3375] fix-test-bug 1 file changed, 1 insertion(+)
⠋$ git merge → mainrunning
| Marker | Meaning |
|---|---|
| ✓ | Operation succeeded. |
| ✗ | Operation failed — the error output is shown inline. |
| ⠿ | Operation in progress. |
Collapsible panel
The whole terminal/console region can be hidden to give the chat and diff more room, and reopened from the Terminal & Console bar. Its open/closed state is remembered.