demian-cli 1.1.2 → 1.2.1

package/README.md

@@ -20,7 +20,8 @@ Additional locale: [한국어](./docs/ko/README.md)
   search, progress reporting, and cowork delegation.
 - Goal mode with `/goal` for longer objectives that should be verified before
   completion.
-- Cowork mode with `/cowork` for bounded multi-agent coordination.
+- Cowork mode with `/cowork` for bounded multi-agent coordination, including a
+  Codex-manager and Claude-Code-worker routing preset.
 - Provider support for OpenAI-compatible APIs, Anthropic API, Codex,
   Claude Code, Ollama, LM Studio, vLLM, llama.cpp, OpenRouter, Together, Groq,
   Gemini, and Azure OpenAI-compatible endpoints.
@@ -76,6 +77,7 @@ npx demian
    - Press `Esc` then `m` to edit the model.
    - Press `Esc` then `a` to choose the main agent.
    - Press `Esc` then `c` to open the config screen for persistent provider/model setup.
+   - In the config screen, press `w` to tune cowork providers, routing, fallback, and permission defaults.
    - Type your request and press `Enter`.
 
 3. Try a first prompt:
@@ -114,7 +116,8 @@ The terminal UI creates `~/.demian/config.json` automatically when no user
 config exists. Press `Esc` then `c` to open the config screen. From there you
 can set the default provider, choose or add a default model profile for a
 provider, edit the selected provider's `baseURL`, `apiKeyEnv`, and auth header,
-and add common provider presets without hand-editing JSON.
+add common provider presets, and tune cowork provider routing without
+hand-editing JSON.
 
 ### OpenAI-Compatible Example
 
@@ -246,6 +249,23 @@ Demian remains the main coordinator. Sub agents are workers with bounded tasks.
 The default cowork settings allow read-only parallelism and keep writer
 coordination conservative.
 
+By default, cowork routing favors Codex-backed agents for planning,
+architecture, research synthesis, and supervisory review. It favors
+Claude-Code-backed agents for bounded implementation, module-level development,
+detailed code review, and specialist work in the local repo. You can tune this
+split from the TUI config screen: press `Esc`, then `c`, then `w`.
+
+The main cowork settings are:
+
+- `cowork.providers`: providers that are allowed to participate in cowork runs.
+- `cowork.routing.agentProviders`: provider priority per agent role.
+- `cowork.fallback.nonWrite`: fallback behavior for read-only, review, and manage work.
+- `cowork.fallback.write`: write repair behavior. Write tasks do not
+  automatically switch providers after partial side effects; Demian rereads
+  changed files and retries repair with the same agent/provider when configured.
+- `cowork.permissionOverlay`: Demian-managed permission defaults that compile
+  into provider runtime tool permissions.
+
 Cowork is most useful for:
 
 - comparing two implementation paths
@@ -418,6 +438,14 @@ The default path is `~/.local/bin/claude`.
 ~/.local/bin/claude --version
 ```
 
+### Cowork does not choose the provider you expected
+
+Open the TUI config screen with `Esc`, then `c`, then `w`. Check that the
+provider is included in `cowork.providers`, then check the agent-specific
+routing order. If a write task fails after partial file changes, Demian keeps
+the same provider and uses the write repair policy instead of falling through to
+another provider.
+
 ### Permission prompts feel too frequent
 
 Use `a` to always allow a specific grant scope, or configure a project policy.