## Summary
- Clarifies in the root README that managed integrations are backend-proxied through OpenHuman's Composio connector layer.
- Updates the integrations docs to distinguish managed mode from direct Composio mode.
- Documents that direct mode needs the user's own Composio API key and separately hosted trigger webhook plumbing.
## Problem
- #2020 asks for clearer disclosure around cloud/backend and integration dependencies.
- The README advertised 118+ integrations with one-click OAuth, but did not state the managed Composio/backend boundary near that claim.
- The integrations page said users did not need to think about Composio, which is true for managed mode but incomplete for direct/BYO mode.
## Solution
- Add a short managed-vs-direct disclosure beside the README integrations bullet.
- Replace the vague Composio parenthetical in the integrations docs with explicit backend, OAuth, rate-limit, and webhook responsibilities.
- Add the direct-mode privacy-boundary change near the existing Privacy boundary section.
## Submission Checklist
- [x] Tests added or updated (happy path + at least one failure / edge case) per [Testing Strategy](../gitbooks/developing/testing-strategy.md#failure-path-requirement) — N/A: docs-only clarification.
- [x] **Diff coverage ≥ 80%** — N/A: docs-only change.
- [x] Coverage matrix updated — N/A: docs-only change.
- [x] All affected feature IDs from the matrix are listed in the PR description under `## Related`
- [x] No new external network dependencies introduced (mock backend used per [Testing Strategy](../gitbooks/developing/testing-strategy.md#mock-policy))
- [x] Manual smoke checklist updated if this touches release-cut surfaces — N/A: docs-only change.
- [x] Linked issue closed via `Closes #NNN` in the `## Related` section — N/A: #2020 is broader; this PR references it as a scoped docs follow-up.
## Impact
- Users evaluating OAuth/integration architecture get clearer docs before connecting accounts.
- No runtime behavior changes.
## Related
- Refs: #2020
- Follow-up PR(s)/TODOs: N/A
- Coverage matrix feature IDs: N/A: docs-only change.
---
## AI Authored PR Metadata (required for Codex/Linear PRs)
### Linear Issue
- Key: N/A
- URL: N/A
### Commit & Branch
- Branch: codex/2020-composio-disclosure-docs
- Commit SHA: 0d5a7ec2
### Validation Run
- [x] `pnpm --filter openhuman-app format:check` — N/A: docs-only change.
- [x] `pnpm typecheck` — N/A: docs-only change.
- [x] Focused tests: N/A: docs-only change.
- [x] Rust fmt/check (if changed): N/A: no Rust files changed.
- [x] Tauri fmt/check (if changed): N/A: no Tauri files changed.
- [x] `git diff --check`
### Validation Blocked
- `command:` N/A
- `error:` N/A
- `impact:` N/A
### Behavior Changes
- Intended behavior change: documentation now names the managed Composio/backend path and direct-mode responsibility split.
- User-visible effect: clearer README/GitBook disclosure for integration setup.
### Parity Contract
- Legacy behavior preserved: no code paths changed.
- Guard/fallback/dispatch parity checks: N/A.
### Duplicate / Superseded PR Handling
- Duplicate PR(s): N/A
- Canonical PR: N/A
- Resolution (closed/superseded/updated): N/A
<!-- This is an auto-generated comment: release notes by coderabbit.ai -->
## Summary by CodeRabbit
* **Documentation**
* Clarified how Composio-backed integrations work in managed mode versus the new direct mode
* Updated documentation to explain that managed mode handles OAuth, rate limits, and webhooks through the backend, while direct mode requires users to manage webhooks with their own Composio API key
<!-- review_stack_entry_start -->
[](https://app.coderabbit.ai/change-stack/tinyhumansai/openhuman/pull/2325?utm_source=github_walkthrough&utm_medium=github&utm_campaign=change_stack)
<!-- review_stack_entry_end -->
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
Co-authored-by: aqilaziz <gonzes7@gmail.com>
Co-authored-by: Steven Enamakel <enamakel@tinyhumans.ai>
## Summary
- Localizes the context-diagram alt text in `README.md`, `README.ja-JP.md`, and `README.ko.md`.
- Leaves the already-present `bash` install fences unchanged.
- Aligns these README variants with the localized alt-text pattern already used by the German and Simplified Chinese READMEs.
## Problem
- #2162 tracks markdown-lint cleanup for root/Japanese/Korean READMEs.
- The install fences are already fixed on current `main`, but the context diagram still used generic English alt text in all three files.
## Solution
- Replace `OpenHuman context diagram` with descriptive localized alt text per README locale.
## Submission Checklist
- [x] Tests added or updated (happy path + at least one failure / edge case) per [Testing Strategy](../gitbooks/developing/testing-strategy.md#failure-path-requirement) — N/A: docs-only alt text change.
- [x] **Diff coverage ≥ 80%** — N/A: docs-only change.
- [x] Coverage matrix updated — N/A: docs-only change.
- [x] All affected feature IDs from the matrix are listed in the PR description under `## Related`
- [x] No new external network dependencies introduced (mock backend used per [Testing Strategy](../gitbooks/developing/testing-strategy.md#mock-policy))
- [x] Manual smoke checklist updated if this touches release-cut surfaces — N/A: docs-only change.
- [x] Linked issue closed via `Closes #NNN` in the `## Related` section
## Impact
- Documentation accessibility metadata improves for screen readers and markdown-lint checks.
- No runtime impact.
## Related
- Closes: #2162
- Follow-up PR(s)/TODOs: N/A
- Coverage matrix feature IDs: N/A: docs-only change.
---
## AI Authored PR Metadata (required for Codex/Linear PRs)
### Linear Issue
- Key: N/A
- URL: N/A
### Commit & Branch
- Branch: codex/2162-readme-alt-locales
- Commit SHA: 0f5a796d
### Validation Run
- [x] `pnpm --filter openhuman-app format:check` — N/A: docs-only change.
- [x] `pnpm typecheck` — N/A: docs-only change.
- [x] Focused tests: N/A: docs-only change.
- [x] Rust fmt/check (if changed): N/A: no Rust files changed.
- [x] Tauri fmt/check (if changed): N/A: no Tauri files changed.
- [x] `git diff --check`
- [x] Verified install fences already use `bash` in the three affected READMEs.
### Validation Blocked
- `command:` N/A
- `error:` N/A
- `impact:` N/A
### Behavior Changes
- Intended behavior change: localized alt text for the README context diagram.
- User-visible effect: better accessibility metadata in README variants.
### Parity Contract
- Legacy behavior preserved: README layout, image path, and install snippets unchanged.
- Guard/fallback/dispatch parity checks: N/A.
### Duplicate / Superseded PR Handling
- Duplicate PR(s): N/A
- Canonical PR: N/A
- Resolution (closed/superseded/updated): N/A
<!-- This is an auto-generated comment: release notes by coderabbit.ai -->
## Summary by CodeRabbit
* **Documentation**
* Improved documentation accessibility and internationalization through refined image alt text descriptions. Updated the OpenHuman context-building diagram descriptions across English, Japanese, and Korean README versions with more accurate, language-appropriate text to better serve all international users and enhance overall documentation clarity.
<!-- review_stack_entry_start -->
[](https://app.coderabbit.ai/change-stack/tinyhumansai/openhuman/pull/2324?utm_source=github_walkthrough&utm_medium=github&utm_campaign=change_stack)
<!-- review_stack_entry_end -->
<!-- end of auto-generated comment: release notes by coderabbit.ai -->
Co-authored-by: aqilaziz <gonzes7@gmail.com>
Co-authored-by: Steven Enamakel <enamakel@tinyhumans.ai>
2026-05-20 15:24:05 -07:00
Blue HoangGitHubcoderabbitai[bot] <136622811+coderabbitai[bot]@users.noreply.github.com>
- Changed the Discord link to point to the new URL: https://discord.tinyhumans.ai/.
- Added a new "Highlights" section detailing key features of OpenHuman, including Neocortex, The Subconscious, Screen Intelligence, and more, with links to their respective documentation.
These updates improve the clarity and accessibility of the README, ensuring users have the latest information and can easily navigate to important features.
- Added a new script `ensure-tauri-cli.sh` to ensure the vendored CEF-aware `tauri-cli` is installed, preventing runtime errors related to missing Chromium Embedded Framework files.
- Updated `package.json` scripts to call `yarn tauri:ensure` before other commands, ensuring the correct CLI is used for building and running the application.
- Enhanced documentation in `CLAUDE.md` and `install.md` to clarify the requirement for the vendored `tauri-cli` and the installation process.
- Improved the `dev:app` and `dev:wry` scripts to streamline the development workflow with the new CLI setup.
These changes enhance the development experience by ensuring the correct tooling is in place for building and running the application with CEF support.
- Revised the feature comparison table for OpenHuman and its competitors, improving descriptions and emphasizing key features such as self-learning capabilities and desktop integrations.
- Streamlined language for better readability and user understanding of OpenHuman's advantages.
- Ensured consistency in formatting and terminology throughout the document.
- Revised the feature comparison table for OpenHuman and its competitors, correcting the formatting and improving descriptions for clarity.
- Removed outdated language and streamlined content to better reflect current capabilities and advantages of OpenHuman.
- Ensured consistency in terminology and improved overall readability of the document.
- Revised the feature comparison table for OpenHuman and its competitors, improving descriptions and adding clarity to the open-source status, simplicity, memory capabilities, API complexity, extensibility, and desktop integrations.
- Streamlined language for better readability and user understanding of OpenHuman's advantages.
- Removed outdated sections to focus on current capabilities and improve overall document quality.
- Removed the legend section from the feature comparison table to streamline the content.
- Adjusted the feature comparison for OpenHuman and its competitors, focusing on clarity and relevance.
- Improved overall readability of the document to better convey OpenHuman's advantages.
- Revised the feature comparison table for OpenHuman and its competitors, improving descriptions of open-source status, cost, memory capabilities, API complexity, knowledge base strength, skills integration, and desktop features.
- Streamlined language for better readability and user understanding of OpenHuman's advantages.
- Corrected minor typographical errors to enhance overall document quality.
- Added a new section highlighting the UI-first approach, emphasizing a clean desktop experience and simplified onboarding process.
- Corrected typographical errors in the subscription model description for clarity.
- Streamlined language to improve overall readability and better convey the advantages of OpenHuman.
- Revised the feature comparison table for OpenHuman and its competitors, improving clarity on open-source status, cost, memory capabilities, API requirements, knowledge base strength, skills integration, and desktop features.
- Corrected minor typographical errors to enhance overall readability.
- Streamlined language to better reflect the current capabilities and advantages of OpenHuman.
- Revised the feature comparison table for OpenHuman and competitors, enhancing clarity on open-source status, cost, self-learning capabilities, API requirements, knowledge base strength, skills integration, and desktop features.
- Corrected minor typographical errors to improve overall readability.
- Streamlined language to better reflect the current capabilities and advantages of OpenHuman.
- Revised descriptions for key features to improve user understanding, including subscription model, memory capabilities, skills integration, and local AI functionalities.
- Consolidated and clarified language around desktop integration and user data management, emphasizing privacy and local processing.
- Removed outdated sections to streamline the document and focus on current capabilities.
* fix(autocomplete): add 30s timeout to inference HTTP client
reqwest::Client::new() creates a client with no timeout, causing
inference calls to block indefinitely when Ollama is slow or
unreachable. Admin endpoints had explicit timeouts but inference
did not.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* fix(autocomplete): improve engine reliability and suppress in-app notifications
- Wrap engine loop refresh() in 15s tokio timeout to prevent blocking
- Handle AX error -1728 (Electron apps) gracefully as idle, not error
- Clear stale state (last_error, suggestion, context) on stop()
- Add skip_apply flag to AutocompleteAcceptParams so frontend can
accept without triggering AppleScript text insertion
- Skip AX-based Tab accept and overlay when OpenHuman is focused
- Guard all show_overflow_badge calls with app_name check to suppress
Script Editor notifications when typing in the chat composer
- Cache inference results: skip Ollama call when context is unchanged
and a suggestion already exists
Closes#107
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* fix(autocomplete): add skip_apply to AutocompleteAcceptParams type
Frontend passes skip_apply: true when accepting ghost text so the
backend only persists for personalization without AppleScript insertion.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* fix(autocomplete): fix ghost text display, alignment, and acceptance
- Fix getInlineCompletionSuffix to handle backend's continuation
suffix format (not just full-string format)
- Add 120s safety timeout to clear isSending if no response arrives
- Match textarea CSS to overlay div (leading-normal, whitespace-pre-wrap,
break-words, font-sans) so ghost text aligns on multi-line wrap
- Pass skip_apply: true when accepting to prevent double text insertion
- Add Right Arrow key acceptance when cursor is at end of input
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* style: apply prettier + cargo fmt formatting
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
* format
* Update README.md to enhance installation instructions and clarify project overview
- Added installation commands for MacOS/Linux and Windows users.
- Removed redundant download section and streamlined the project description.
- Updated the GitHub star section to be commented out for clarity.
This update improves user onboarding by providing clear installation steps and a concise project overview.
---------
Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>
Co-authored-by: Steven Enamakel <enamakel@tinyhumans.ai>
