@makerbi/openclaude 0.20.1 → 0.21.0

package/README.md

@@ -100,6 +100,27 @@ Inside OpenClaude:
 
 > **Note:** OpenClaude does not automatically load project `.env` files. We recommend using the `/provider` command for setup, which saves provider profiles and credentials in `.openclaude-profile.json`. If you prefer environment variables, export them explicitly or run `openclaude --provider-env-file .env` for provider/setup variables. Export runtime/debug knobs from your shell or launcher.
 
+### Resume or fork a conversation
+
+Resume an existing conversation by session ID, or continue the most recent
+conversation in the current directory:
+
+```bash
+openclaude --resume <session-id>
+openclaude --continue
+```
+
+Add `--fork-session` to branch the conversation history into a new session ID
+instead of reusing the original transcript:
+
+```bash
+openclaude --resume <session-id> --fork-session
+openclaude --continue --fork-session
+```
+
+Forking is conversation branching only. It does not create filesystem isolation,
+copy your working tree, or create a git worktree branch.
+
 ### Background sessions
 
 Run long non-interactive prompts detached from the current terminal:
@@ -170,6 +191,13 @@ $env:OPENAI_MODEL="qwen2.5-coder:7b"
 openclaude
 ```
 
+For Ollama, OpenClaude uses Ollama's native chat API and requests a 32768-token
+context window on each chat request so same-session history is not silently
+truncated by Ollama's OpenAI-compatible shim. Set `OPENCLAUDE_OLLAMA_NUM_CTX`
+or `OLLAMA_CONTEXT_LENGTH` if you need a different request-level context size.
+See [Advanced Setup](docs/advanced-setup.md#ollama-context-length) for
+verification with `ollama ps`.
+
 ## Setup Guides
 
 Beginner-friendly guides:
@@ -191,6 +219,7 @@ Advanced and source-build guides:
 | Z.AI GLM Coding Plan | `/provider` or OpenAI-compatible env vars | Uses `OPENAI_API_KEY` at `https://api.z.ai/api/coding/paas/v4` and defaults to `glm-5.2` |
 | Hicap | `/provider` or OpenAI-compatible env vars | Uses `api-key` auth, discovers models from unauthenticated `/models`, and supports Responses mode for `gpt-` models |
 | Fireworks AI | `/provider` or env vars | First-class provider with 276 curated models (DeepSeek, Qwen, Llama, Gemma, and more); uses `FIREWORKS_API_KEY` |
+| ClinePass | `/provider` or env vars | AI model gateway with usage limits (5hr, weekly, monthly); uses `CLINE_API_KEY` at `https://api.cline.bot/api/v1` |
 | Gemini | `/provider` or env vars | Supports API key only |
 | GitHub Models | `/onboard-github` | Interactive onboarding with saved credentials |
 | Codex OAuth | `/provider` | Opens ChatGPT sign-in in your browser and stores Codex credentials securely |
@@ -242,6 +271,20 @@ The `is_async` field reported in the `tengu_agent_tool_selected` event and the a
 
 For best results, use models with strong tool/function calling support.
 
+### Agent step limits
+
+Custom agents can define `maxSteps` as a positive integer to cap how many tool-use steps a sub-agent may execute. When the limit is reached, OpenClaude stops additional tool calls and asks the sub-agent for a concise final summary covering completed work, findings, remaining tasks, and whether another run is needed. Omitting `maxSteps`, or setting it to an invalid value such as `0` or malformed input, preserves the default unlimited behavior.
+
+```markdown
+---
+name: bounded-researcher
+description: Use for focused research with bounded tool use
+maxSteps: 8
+---
+
+You are a focused research agent.
+```
+
 ## Agent Routing
 
 OpenClaude can route different agents to different models through settings-based routing. This is useful for cost optimization or splitting work by model strength.
@@ -424,7 +467,6 @@ Coverage output is written to `coverage/lcov.info`, and OpenClaude also generate
 - `src/` - core CLI/runtime
 - `scripts/` - build, verification, and maintenance scripts
 - `docs/` - setup, contributor, and project documentation
-- `python/` - standalone Python helpers and their tests
 - `vscode-extension/openclaude-vscode/` - VS Code extension
 - `.github/` - repo automation, templates, and CI configuration
 - `bin/` - CLI launcher entrypoints

package/bin/openclaude

@@ -78,7 +78,7 @@ function relaunchWithLongSessionHeapIfNeeded() {
   // Preserve the original argv[1] (which may be a symlink like
   // /usr/local/bin/openclaude) instead of resolving it via import.meta.url.
   // Resolving symlinks here defeats install-type detection downstream: a real
-  // npm global install (symlink → node_modules/@gitlawb/openclaude/bin) would
+  // npm global install (symlink -> node_modules/@makerbi/openclaude/bin) would
   // resolve to the package's real path inside node_modules, which is fine, but
   // a `npm install -g .` dev symlink resolves back to the repo and looks like
   // a source-tree dev run. Using argv[1] keeps the invocation path stable so