Skip to content

docs: add "Why This Fork?" section to README (LAC-1469) #21

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
lacymorrow merged 1 commit into from
May 16, 2026
+14 −0
Merged

docs: add "Why This Fork?" section to README (LAC-1469) #21

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
14 changes: 14 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -41,6 +41,20 @@

[![OpenCode Terminal UI](packages/web/src/assets/lander/screenshot.png)](https://opencode.ai)

## Why This Fork?

This is a maintained fork of [anomalyco/opencode](https://github.com/anomalyco/opencode). We forked to extend OpenCode with shell-native features we need for our own workflows that haven't landed upstream yet:

- **Shell mode** — a first-class execution mode (`ctrl+space` or `!` prefix) that runs commands in a live shell instead of routing through the AI, with a distinct color bar in the TUI prompt
- **Working directory tracking** — `getCwd()` / `setCwd()` persists the shell cwd across commands; a sentinel in bash output propagates `cd` changes back to the UI footer
- **Natural language detection** — automatically routes input to AI when it reads like a question or instruction, to shell when it reads like a command — no prefix needed in `auto` mode
- **Double left border UI** — two side bars in the TUI prompt: outer bar = agent color, inner bar = execution mode color, using a row layout that keeps both bars at equal height
- **Tab → shell autocomplete** — Tab triggers shell completion; Shift+Tab cycles agents (upstream maps Tab to agent cycle)
- **`EventCwdUpdated` SDK type** — exposes working directory change events through the JS SDK
- **Independent versioning** — lash uses its own versioning scheme and is published independently of upstream releases

We keep the fork in sync with upstream (`git fetch upstream && git merge upstream/dev`) and document merge conflicts in [UPSTREAM_SYNC.md](./UPSTREAM_SYNC.md).

---

### Installation
Expand Down
Loading