# Roadmap Codewhale is the open-source agent between you and any model. You can read its code, or ask it to read its own code and explain what it does. This page says where the project is going and where help counts most. It has two parts, the long-term goals that change slowly and the releases that change every few weeks. Nothing here is a promise or a date. A milestone is a plan, and a release exists only when its tag and downloads do. The [changelog](../CHANGELOG.md) is the record of what shipped. ## How the project improves Codewhale is what it is because people used it on machines, providers, shells and languages the maintainers do not have, and then said what happened. Each bug report, each screenshot of something that looked wrong, each confused first run, each translation and each provider fix moved the project. We want that loop to keep running, release after release. So all feedback is welcome, including "this felt off" with no proposed fix. You do not need to write code to shape Codewhale. See [how to contribute](../CONTRIBUTING.md) for where each kind of help goes. ## Long-term goals Each goal names the open questions, because that is where a new idea or a report is most likely to change the outcome. ### 1. One engine behind every way to use it One Rust engine runs the turn, the tools, permissions, sessions and receipts. The terminal app, `codewhale exec`, the local web UI, the [Runtime API](RUNTIME_API.md), editors over the Agent Client Protocol and the desktop app in development are all clients of it. A fix in the engine reaches every client, and no client grows a second agent loop. What is still open: the largest crates still need to be split ([#5316](https://github.com/codewhale-hq/CodeWhale/issues/5316), [#5586](https://github.com/codewhale-hq/CodeWhale/issues/5586)), and the desktop app has no public download yet ([#4986](https://github.com/codewhale-hq/CodeWhale/issues/4986)). ### 2. Every model is a peer More than 40 providers are built in, along with any OpenAI-compatible endpoint and local runtimes. No provider is ranked above another. A provider that behaves differently is described by a profile, not by special cases scattered through the code. What is still open: Responses API behavior needs to move into provider profiles ([#5092](https://github.com/codewhale-hq/CodeWhale/issues/5092), [#5093](https://github.com/codewhale-hq/CodeWhale/issues/5093)), and the community uses many providers and models that we have not tested. The [provider list](PROVIDERS.md) is a standing project, so additions and corrections are welcome at any time. ### 3. You stay in control, and you can see what happened Codewhale asks before it does something you did not allow, runs commands in a sandbox where the system has one, and keeps a receipt of every file changed, command run and call made. A cost it does not know is shown as unknown, never as free. What is still open: Windows has no OS sandbox yet, approval prompts could be clearer, and we want to hear about every case where Codewhale refused something reasonable or allowed something it should have asked about. Those reports are among the most useful we get. ### 4. Many agents working side by side Sub-agents, fleets and workflows let several agents share a job. Other coding agents can run as Codewhale agents too, so you can keep the tools you already use and see their work in one place. What is still open: long-running work needs to survive restarts and cancellation cleanly, a finished goal needs independent verification ([#6013](https://github.com/codewhale-hq/CodeWhale/issues/6013)), and context needs to stay useful in very long sessions ([#7206](https://github.com/codewhale-hq/CodeWhale/issues/7206), [#6426](https://github.com/codewhale-hq/CodeWhale/issues/6426)). ### 5. Bring what you already have Codewhale reads `AGENTS.md`, imports Claude Code settings and plugins, speaks MCP, and runs reviewed [DeepSeek Harness plugins](DSH_PLUGIN_COMPAT.md). Switching should not mean starting over. What is still open: DeepSeek Harness plugins are not yet fully compatible on macOS, Linux and Windows, and we want to hear about each plugin, skill or config format that does not import the way you expected. ### 6. For everyone, in their language, on their machine The README ships in 19 languages, and the terminal and website are localized. Codewhale runs on macOS, Linux and Windows, with preview or community support for Termux, HarmonyOS and more. Accessibility is part of the work, not an extra. What is still open: translation is a standing project ([localization matrix](LOCALIZATION.md), [Chinese localization group](https://github.com/codewhale-hq/CodeWhale/issues/6804)), and so are input methods ([#2323](https://github.com/codewhale-hq/CodeWhale/issues/2323)), screen readers ([accessibility](ACCESSIBILITY.md)) and new platforms such as FreeBSD ([#1097](https://github.com/codewhale-hq/CodeWhale/issues/1097)). ### 7. A project that helps build itself Codewhale is used to work on Codewhale. A well-written issue is something an agent can pick up and finish, and a person reviews the result. The better the tool gets, the faster it can improve, and the more a clear report is worth. What is still open: memory that carries across sessions ([#6050](https://github.com/codewhale-hq/CodeWhale/issues/6050)) and skills that Codewhale learns with your approval ([#5860](https://github.com/codewhale-hq/CodeWhale/issues/5860)) are both at the design stage. ## Releases The latest release is on the [releases page](https://github.com/codewhale-hq/CodeWhale/releases). `main` holds the next one while it is being built. | Milestone | What it is for | | --- | --- | | [0.10.3](https://github.com/codewhale-hq/CodeWhale/milestone/73) | This release is in progress; follow [#7284](https://github.com/codewhale-hq/Codewhale/issues/7284) for what is left and how to help. It fixes undo, sign-in, model selection and install problems reported against 0.10.2, and it adds DeepSeek Harness plugin compatibility and ACP in both directions: other agents running inside Codewhale, and editors driving Codewhale. Codex App Server v2 compatibility moved out of this release. The changelog lists its [known limits](../CHANGELOG.md). | | [0.10.4](https://github.com/codewhale-hq/CodeWhale/milestone/75) | This release improves reliability through process cleanup, resource limits, fail-closed error handling and dead-code removal. | | [0.10.5](https://github.com/codewhale-hq/CodeWhale/milestone/76) | This release improves usability with running-command detail, usage and tool diagnostics, and file previews. | | [0.11](https://github.com/codewhale-hq/CodeWhale/milestone/72) | This release reworks the architecture with smaller crates, provider profiles, one command contract and cache-stable context folding. | | [1.0](https://github.com/codewhale-hq/CodeWhale/milestone/66) | This longer-term release brings the desktop app to every platform and adds pluggable memory and approved skill learning. | | [Backlog](https://github.com/codewhale-hq/CodeWhale/milestone/69) | These are ideas we kept without a release, and nothing here blocks one. | Scope moves between milestones as we learn. If something you need is in a later milestone or missing, say so on its issue or open one, because that is how priorities get corrected. ## Where to start - The [help wanted](https://github.com/codewhale-hq/CodeWhale/issues?q=is%3Aissue+is%3Aopen+label%3A%22help+wanted%22) label marks scoped issues that a contributor can pick up, and you can comment on one to claim it. - You can add a 👍 to any [open issue](https://github.com/codewhale-hq/CodeWhale/issues) you care about, and we read that as a real signal. - [Ideas](https://github.com/codewhale-hq/CodeWhale/discussions/categories/ideas) in Discussions is the place for something you want to talk through before it becomes an issue. - You can chat on [Discord](https://discord.gg/37gfS3ksug), or add `hunterbown` on WeChat and ask to join the Whale Brothers group. Everyone is welcome.