=%@@@@@@@- .@@@@@@@@+ .=*%@::@%*=. -@@@@@@@% #@@@%*- #@@@@@@@:-@@@%*- :%@@@@@@@@-=@@@@@@@@%: *@@@@@@@.=@@@@@+ =@@@@@@@@%- .%@@@@* .=#@@-.%@#=#%+@@@@@@% .@@@@@@@: +@@@@: :@@@@+ .@@@@@@% +@@@@@# *@@@@@@- .%@@@@#. %@@@@@@: :@@@@@@% +@@@@@@: .:*@@+ :@@@@@@@. =@@- =@@@#. -#@@@%@@@@@@* :.@@@@@@@. .%@@@@% @@@@@% @@@@@@% .@@@@@@= +@@@@@@- *@@@@@# %@@@@@@. .@@@@@@# =@@@@@@: =@+ .@@@@@@@ @# =@@@@* +@@.@@@@@@@::+ @@@@@@@. #@@@@@% @@@@@@* @@@@@@% :@@@@@@- +@@@@@@- *@@@@@@ %@@@@@@. .@@@@@@# =@@@@@@: =# -. .@@@@@@@ @# %@@@@@%+-. ##-:=@@@@@@%%+ @@@@@@@. :@@@@@@% @@@@@@@. @@@@@@% :@@@@@+ +@@@@@@- *@@@@@# %@@@@@@. .@@@@@@# =@@@@@@: -@@ .@@@@@@@ @# *@@@@@@@@@%*--% %@@@@@@@. @@@@@@@. =@@@@@@% @@@@@@@- @@@@@@% *@@@#=. +@@@@@@- :@@@@@#. %@@@@@@ =##@@@@@@# =@@@@@@.=@@% .@@@@@@@ @# .#@@@@@@@@@@@%-:@-.@@@@@@* .@@@@@@@. -@@@@@@% @@@@@@@: @@@@@@% -#@@@%#= +@@@@@@::%%%#+: %@@@@@@. :@@@@@@# =@@@@@@: -@@ .@@@@@@@ @# -#@@@@@@@@@@@--@= +@@@@@ .@@@@@@@. @@@@@@% @@@@@@% @@@@@@% :@@@@@@- +@@@@@@- %@@@@@@. .@@@@@@# =@@@@@@: =# .. .@@@@@@@ @# +* .-+#@@@@@@@#:@- %@@@= .@@@@@@@. =@@@@@% @@@@@@- @@@@@@% :@@@@@@= +@@@@@@- %@@@@@@. .@@@@@@# =@@@@@@: .@# .@@@@@@@ @* %@+ -%@@@@++@* :@@% @@@@@@@. =@@@@% @@@@@- @@@@@@% .@@@@@@**+ +@@@@@@: %@@@@@@ .@@@@@@# =@@@@@@: =@@* %@@@@@@. .#@. #@@+ *@@@#-#@@@%- +@: -%@@@@@@@%= .+%@@#..#@@%+. :#@@@@@@@#. +@@@@@@%: +@@@@@@@%= .#@@@@@@@%--%@@@@@@@#. +@@@@@@@.-#@@@@# =#@@@@@+ =#@#. %@@@@*: +%@@#-.-:::-. : .-:::::::-. .-+..+-. .-:::::::- .-==-. :::::::::: -:::::::-..-:::::::- :::::::: .-::::. .:-=== --. :- .-+- +=:.

Many agents, one project.

Software engineering is where Morpheus is strongest today. The larger ambition is to make it useful across the many ways people can work with agents.

So what the hell is the Morpheus agent?

A general-purpose agent for people who ship software. It reads and writes code like the coding agents you already use, and it goes past the editor into graphical applications: it operates real interfaces through an accessibility tree and falls back to screenshots only when nothing else works.

The part that matters today is orchestration. Every harness is state of the art at something, and none of them is the best at everything. So instead of betting on a single assistant, you run several in the same workspace (Claude, Gemini, Codex, Cline, whichever you trust), each with its own session, model and working tree. The Morpheus agent coordinates them: it sends each piece of work to the agent best suited for it, collects the reports and keeps the project in one piece.

Install

Get cosh on your machine.

One command on Linux and macOS, one on Windows. Or grab a prebuilt binary for your platform below.

bash · Linux & macOS
curl -fsSL https://raw.githubusercontent.com/aidreamy/morpheus/main/download.sh | bash
powershell · Windows
irm https://raw.githubusercontent.com/aidreamy/morpheus/main/download.ps1 | iex

Why use Morpheus over the other options on the market?

  • Allows you to enable or disable tools, keeping the model's context clean by excluding descriptions of disabled tools.
  • Integrates with any agent that exposes an ACP server.
  • Use, modify, and redistribute Morpheus under the Apache-2.0 license.
  • Multi-agent collaboration: run Claude, Gemini, Codex, Cline and others in the same TUI, in a shared workspace where they communicate and coordinate.
  • Computer tools via the accessibility tree: reads and operates graphical interfaces through a structured representation, falling back to screenshots only when needed. Fewer tokens.

Look at our TUI test and see simulated details

Quick guide
← esc
let's go!
Managerprovider model max
tab change mode
v0.3.0
main /home/user/project

Features

One place to run the agents you already trust.

cosh is not another model. It is the orchestration layer around them: a shared workspace, a complete coding harness, and one surface to steer every agent on the project.

Agent orchestration

Run Claude, Gemini, Codex, Cline and any ACP harness side by side. Each pane keeps its own session, model and optional worktree, while the manager splits the work, queues the turns and collects the reports.

Talk to any agent

Message any ACP agent straight from the same prompt. No detour through the manager, no context switch, no losing the thread — every agent in the workspace is addressable directly.

Computer tools

The agent reads and drives desktop apps through the accessibility tree, falling back to screenshots only when it must. Fewer pixels, fewer tokens.

Many interfaces

Start in the TUI. WhatsApp and a graphical interface are in development, sharing the same harness, sessions and workspace.

A real harness

A complete, mature coding harness: hash-checked edits with rollback, search, LSP, streaming bash, skills, subagents, compaction and a shared task board built for long sessions.

FAQ

Questions, answered.

Short answers to the things people ask most before trying cosh. For the full list, see the dedicated FAQ page.

What is Morpheus?

Morpheus is a general-purpose agent. Its harness brings together tools for file editing, search, shell, LSP and web, along with computer tools for observing and controlling graphical applications through the OS accessibility tree.

How do I install the local-embedding variant?

Set COSH_VARIANT=slim-embed when running the installer to get local RAG with fastembed. On Linux x64 (or WSL), run curl -fsSL https://raw.githubusercontent.com/aidreamy/morpheus/main/download.sh | COSH_VARIANT=slim-embed bash. On Windows x64, run $env:COSH_VARIANT = "slim-embed", then irm https://raw.githubusercontent.com/aidreamy/morpheus/main/download.ps1 | iex.

Which platforms are supported?

Linux and Windows are tested. macOS builds are published but haven't been tested yet. Prebuilt binaries are available for x64 and arm64.

Which providers and models does it support?

Morpheus ships native adapters for Claude, OpenAI and Gemini, plus an OpenAI-compatible connector family covering Amazon Bedrock, Kimi, Groq, OpenRouter, Nvidia and more. Local servers like Ollama can be added with /providers, and custom providers or ACP agents in Settings → Integrations. Everything is picked inside the TUI with /models.

What are the operating modes (Build / Ask / Yolo / Command / Manager)?

Cycle modes with Tab or Ctrl+I. Build (default) lets the agent work with approval prompts for shell commands and other gated actions. Ask limits the agent to read-only tools. Yolo runs enabled tool calls without approval. Command turns the TUI into a direct shell: your input runs as a command without an LLM call. When the session has /agents panes, Manager replaces Command in the cycle; it coordinates those agents, inspects and verifies their work, and delegates file changes because its own file-write tools are unavailable.

What does Morpheus cost?

Morpheus itself is free and open source under Apache-2.0. You pay only your model provider's API usage — the session tracks token counts and cost as you go. Without a provider configured, Morpheus points you to a free third-party gateway with OAuth sign-in.

Does Morpheus collect my data?

No conversations, code or credentials are ever sent. Telemetry is limited to aggregated product metrics (session duration, token counts, provider/tool usage categories, error kinds) and can be disabled in /settings → General.

What are the computer tools?

Morpheus observes and drives native desktop applications through the OS accessibility tree (X11 and Wayland), with screenshots as a fallback. It reads a structured, compact representation of the interface, so fewer tokens are consumed, and can perform window verbs: activate, minimize, maximize, move, resize and close.

How does the /agents multi-agent mode work?

The /agents split runs external agents (Gemini, Claude, Codex, Cline and other ACP harnesses) alongside the main agent, one pane each, all sharing a single prompt. Every pane keeps its own session, model and optional git worktree; the main agent dispatches tasks and collects reports.

How do I report a bug or contribute?

Open an issue on GitHub with as much detail as possible — bugs, platform quirks (especially macOS) and feature suggestions are welcome. The project is Apache-2.0, and its building blocks ship as reusable crates: morpheus-sdk, morpheus-tools, morpheus-tui and morpheus-recall.