Repository navigation
Releases
MechApe 0.1.10
MechApe 0.1.10 adds context inspection, writing-brief drafting with editable review before saving, and conversation branching. It also includes privacy/security hardening and keeps Send/Stop visible in narrow sidebars.
The plugin remains free/MIT. Project boundaries, excluded folders, read-only skills, write approval, stale-edit protection, cancellation, and recovery safeguards remain enforced. Cloud providers require your own account/API key and bill usage separately.
Validation: 57 automated tests; Windows/macOS/Linux CI; production package checks; GitHub attestations for all three assets; live OpenRouter catalog/read/create/update with two review callbacks; disposable-vault checks for context disclosure, streamed reply, Stop, reviewed brief saving, branching, reload, and narrow sidebar layout. Direct Anthropic live chat retains the previously documented account-credit limitation; fixture coverage is not a live provider test.
Requires Obsidian 1.14.5 or later on desktop. Install main.js, manifest.json and styles.css, or update through Obsidian when the Community directory offers this release.
MechApe 0.1.9 — Obsidian helper fix
MechApe 0.1.9
Fix the Obsidian Community obsidianmd/prefer-create-el warning by creating the skill-import file picker with Obsidian's createEl helper. Skill imports, folder imports, and reference attachments retain the same behavior.
Includes all skill-import and reference features from 0.1.8.
MechApe 0.1.8 — Skill imports and references
MechApe 0.1.8
Import reusable skills and keep their supporting references together.
- Import Markdown instructions, a folder containing
SKILL.md, or a.skill/ ZIP package from Settings → MechApe. - Preserve skill instructions, frontmatter, and nested text references. Each import creates a separate read-only profile.
- Attach, preview, and remove UTF-8 text references on any skill. Duplicated profiles have independent reference copies.
- Include reference text when a skill is active, framed as source data, with a 32,768-character budget and explicit truncation notices. References are sent to the selected local or cloud provider; scripts are never executed.
- Reject unsafe paths, duplicate reference names, ambiguous packages, and oversized imports. Binary and non-UTF-8 files are reported as skipped.
- Preserve the 0.1.7 Community review fixes, searchable settings, saved-setting validation, and GitHub build attestations. Use the patched fflate 0.8.3 ZIP reader.
Reference copies are saved in the vault's plugin settings and may be included in vault backup or sync. PDF, image, and Office-document extraction is not supported. Desktop and Obsidian libraries remain separate.
Validation: 52 automated tests pass, including package imports, reference persistence and model context, invalid paths, and context limits. TypeScript, bundling, release packaging, and dependency audit pass with zero known vulnerabilities. Direct Anthropic live chat remains limited by test-account billing; macOS/Linux native app testing remains outstanding.
MechApe 0.1.7
MechApe 0.1.7
Addresses the initial Obsidian Community review:
- Validate streamed JSON and saved settings before using typed fields; reject malformed content/tool indexes and preserve reasoning metadata for tool round trips.
- Use the searchable Obsidian settings API and update() when providers or skill profiles change.
- Use browser-window draft timers, typed error handling and standard desktop HTTP imports.
- Retain control-character path rejection without a control-character regular expression.
- Point fundingUrl directly to the existing PayPal tip jar because the custom redirect was unreachable to the scanner. Donations remain optional and outside the plugin UI.
- Attach GitHub build provenance attestations to the three plugin assets. Checksums remain available locally; only supported plugin files are attached to new releases.
- Explain local vault-path enumeration and include the public listing screenshots in the repository.
The same reviewed-write and project-boundary rules apply. Direct Anthropic live chat remains limited by test-account billing; macOS/Linux native app testing remains outstanding.
MechApe 0.1.6
MechApe 0.1.6
A free desktop Obsidian companion with reviewed note operations.
- Stream replies from Ollama, OpenRouter, Anthropic, and OpenAI-compatible providers; Stop cancels the connection and keeps partial text.
- Search models and project folders from collapsible Chat options.
- Choose reusable skills with
/in the composer. - Follow selected folders, inspect the context chip, or lock the project while browsing.
- Save transcripts and drafts locally and reopen them from History. Restored chats start fresh model context.
- Keep API keys in memory by default; opt into plain-text storage with Remember API keys. Existing saved-key installations retain their preference.
- Keep explicit Apply/Reject note review, read-only profiles, excluded folders, and stale-edit protection.
History is plain text in the plugin folder and may be copied by vault sync/backups. The README explains storage and provider data transmission. The plugin is desktop-only; mobile is not supported. Experimental Image Studio integration is excluded. Donation links use only the manifest’s fundingUrl.
Validation: see TESTING.md. OpenRouter streaming was tested live on Windows; direct Anthropic chat remains limited by test-account billing. Fixture tests do not imply live certification of every provider/model. macOS/Linux CI does not replace native Obsidian UI testing.
Install the three individual assets together. SHA256SUMS.txt contains their integrity hashes. Community-directory submission and review are separate from this GitHub release.
MechApe 0.1.5
MechApe for Obsidian remains free. This release adds an optional PayPal tip link in plugin settings and donation metadata. Tips support development; they do not unlock features or purchase the standalone desktop edition.
Validation: 26 tests passed, TypeScript and release packaging passed, and release asset SHA256 digests match the locally tested build. Vault permissions, read-only skills, and per-write review remain intact. Direct Anthropic live testing remains limited by the previously documented account-credit issue.
MechApe 0.1.4
MechApe 0.1.4
Both editions now use @mechape/core 0.2.0 for provider request/response adapters and the bounded agent loop. The plugin retains its own VaultTools executor, project/excluded-folder boundaries, read-only permissions, approval dialogs, read-before-edit and concurrent-edit checks. No desktop capabilities are granted to the plugin.
Verification: all 26 plugin tests pass, including end-to-end approved/rejected/stale/cancelled writes through the shared loop. TypeScript, production packaging and Windows/macOS/Linux CI pass. Release assets match the tested local build. Fresh live OpenRouter read/create/update with two review callbacks and local Ollama-compatible tool round trips pass using synthetic notes only.
The shared core has 21 contract tests and package-install checks; desktop integration also passes its own tests. Direct Anthropic protocol handling is covered by automated tests, but live chat remains unverified due to the test account's billing limitation. The plugin remains free and desktop-only; directory submission is still a separate step.
MechApe 0.1.3
MechApe 0.1.3
Both MechApe hosts now depend on the public @mechape/core 0.1.0 package. The plugin bundles the package into main.js and retains its MIT attribution; no runtime package install or private-repository access is needed. Copied core sources are removed. Vault boundaries, write approval, and concurrent-edit protections remain host-enforced.
Verification: clean npm ci, all 21 plugin tests, strict TypeScript checking, production packaging, and CI on Windows/macOS/Linux pass. CI release assets match the local build byte for byte. Both host lockfiles pin the same package URL and SHA512 integrity. The core package's own six contract tests and packaged-install checks pass on all three platforms.
This release changes packaging rather than provider behavior. Prior live OpenRouter and local-compatible results remain documented in TESTING.md. Direct Anthropic chat remains unverified due to account billing. Mobile is disabled. The plugin remains free; desktop purchase/activation is separate.
MechApe 0.1.2
MechApe 0.1.2
Free Obsidian vault companion, prepared for community review.
- Shares MechApe's OpenRouter privacy/caching policy, prompt composition, and skill parser with checksum verification and MIT attribution.
- Keeps project boundaries, read-only skills, review-before-write, and concurrent-edit protection.
- Links the separate desktop experience through its public website.
Verification: all 21 tests pass; Windows, macOS and Linux CI pass; CI-built files match the local build. Fresh OpenRouter synthetic note read/create/update and local Ollama OpenAI-compatible tool round-trip checks passed. Direct Anthropic chat remains unverified due to insufficient credits on the test account. Plugin mobile support is disabled.
Install the three individual files in .obsidian/plugins/mechape, or extract the supplementary ZIP. Provider API charges are separate; the plugin itself is free. See README for network and key-storage disclosures and SUBMISSION.md for the community listing worksheet.
MechApe 0.1.1
MechApe 0.1.1 improves billing-error messages and records authenticated cloud validation.
Fixed
- Recognized insufficient-credit errors now explain that API billing must be checked, including Anthropic's HTTP 400 response and OpenRouter HTTP 402.
- Error classification never displays arbitrary provider response bodies or credentials.
Verified
- 18 automated tests, strict TypeScript build, and release verification pass on Windows, macOS, and Ubuntu CI.
- OpenRouter with
anthropic/claude-haiku-4.5: model discovery, real read/create/update calls, tool-result round trips, and final answer passed. - Live Obsidian on Windows: model refresh, note reads, creation/update review dialogs, approved writes, and rejection without a file being created passed in a dedicated test project.
- Anthropic authenticated model discovery succeeded. Its chat request was rejected for insufficient API credits. The improved error message was checked against that real response; successful Anthropic chat/tool use is not claimed.
Remaining limitations
Anthropic chat verification awaits account credits. macOS/Linux coverage is build/test CI, not an Obsidian application test. This release remains desktop-only. See TESTING.md for exact coverage and README.md for network and plaintext API-key storage disclosures.
Installation and submission
The required main.js, manifest.json, and styles.css assets are attached. The ZIP contains the mechape plugin folder for manual installation. Requires Obsidian 1.14.5 or later.
This release is published with the Anthropic billing limitation documented. No community-directory submission has been made.