# Add to your Claude Code skills
git clone https://github.com/verseles/codewalk
README.md
CodeWalk
A native (really fast!!) cross-platform client for OpenCode server mode. Built with Flutter, it provides a conversational interface for session-based AI coding interactions over HTTP APIs and streaming events.
Unique Features
🎙 Speech-to-text on every platform, including Linux
💬 Canned answers for faster replies
↩️ Easier undo and redo
🧙 OpenCode setup wizard
Highlights
Realtime AI chat with streaming responses (SSE) and robust turn reconciliation
Queued Send now handoff without false abort error noise or duplicate chat bubbles
Instant session reopen with cached grouped history, direct bottom landing, and background delta-style revalidation
Load older message history by scrolling to the top of chat
Project-centric sidebar with conversations grouped by open projects
Context-scoped conversation pinning to keep priority sessions at top
Canned answers with global/project scope
Project context support for both Git repositories and non-Git folders
Per-project New Chat draft isolation with lazy session bootstrap
flutter run -d linux
flutter run -d chrome
flutter run -d android
Build artifacts (examples):
flutter build linux
flutter build web
Make Targets
make check # deps + codegen + analyze + test
make check-fast # deps + codegen + analyze + test-fast
make test-fast # excludes slow/integration tags
make android # build arm64 APK
make precommit # check + android
Server Configuration
Launch the app and open Settings from the sidebar
Tap Add Server and run the Quick setup command in your terminal
Keep the default Server URL (http://127.0.0.1:4096) or set your server URL
Configure Basic Auth only if your server requires it
Save and switch active/default profiles as needed
OpenCode Project Agent
When you run OpenCode from this repository, the repo ships a project agent at .opencode/agents/opencodeNews.md:
@opencodeNews reviews the latest OpenCode release for CodeWalk impact
@opencodeNews review vX.Y.Z or @opencodeNews check https://github.com/anomalyco/opencode/releases/tag/... reviews a specific release target mentioned in the same prompt
The agent returns a release summary, impact/risk by area, proposed adjustments, and an execution plan only when CodeWalk work is needed.
Architecture
The project follows Clean Architecture with three layers: Domain, Data, and Presentation. Dependency injection via get_it, HTTP via dio, state management via provider.
Commercial: A separate commercial license is available for organizations with annual revenue exceeding USD 1M that wish to use the software without AGPLv3 obligations.
Origin and Acknowledgment
CodeWalk is a fork of OpenMode, originally created by easychen. The original project is licensed under MIT.
Substantial modifications have been made since the fork, including licensing changes, code restructuring, rebranding, full English standardization, and documentation rewrites. All modifications are licensed under AGPLv3 (or the commercial license, where applicable).
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
