Skip to content

v0.1.0-rc3 — agent-first brand consolidation + memexa demo + --json mode

Pre-release
Pre-release

Choose a tag to compare

View all tags
@labazhou2024 labazhou2024 released this 16 May 14:21
· 10 commits to main since this release
v0.1.0-rc3
9c8119a
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

Third release candidate on the v0.1.0 line. Closes out the first-experience path for both human users and AI agents.

Note on release timing: An initial v0.1.0-rc3 release on 2026-05-16 13:59 UTC failed to publish to PyPI because pyproject.toml version had not been bumped from rc2 to rc3 — twine silently skipped the upload via `--skip-existing`. PR #15 corrected the version field and added a pre-flight checklist to internal protocol to prevent recurrence. This release supersedes that one.

Highlights

Agent-first positioning clarified. memexa is a memory backend that AI agents (Claude Code, Cursor, Cline) invoke as a subprocess on a human user's behalf. Direct CLI use is secondary. See docs/why.md for the per-capability comparison vs OpenHuman / MemPalace / ReMe and the agent-first design rationale.

New features

  • `memexa demo` — thirty-second onboarding. `pip install --pre memexa && memexa demo` ingests a synthetic dataset with the stub extractor and runs five sample queries in the terminal. No Docker, no LLM API key, no configuration.
  • `--json` output mode for all fourteen query subcommands. Top-level flag short-circuits text rendering and emits the raw return value as JSON. Designed for AI agents invoking memexa via shell subprocess.

New docs

  • docs/why.md (bilingual) — comparison matrix, agent-first design rationale, glossary covering V2 envelope / reflow / Chinese-IM reflow / audio + voice reflow / workflow spec terms.
  • docs/cost.md (bilingual) — DeepSeek / GPT-4o / Claude monthly cost estimates with three-tier user profiles. Recommended Flash-gate + Pro-extract combination at ¥0.30 per 1 000 messages.

Brand and roadmap consolidation

  • README first screen restored to include the AI-agent compatible by design paragraph and a dual-path Quickstart (humans run `memexa demo`, agents call subcommands with `--json`).
  • `docs/quickstart.md` Tier 0 expanded with the agent subprocess path.
  • ROADMAP v0.2 redefined from "Python deliverable code + CLI subcommands" to Markdown workflow specs under `docs/templates/`. v0.5 promotes the subprocess path to a native MCP server. v0.7 formalises user-authored specs. New v0.8+ section for optional desktop GUI exploration.
  • Makefile lint / format paths corrected to `memexa tests` (residue from PR #9's src→memexa rename).

Tests

  • 8 new tests across two files (`tests/integration/test_demo_subcommand.py` and `tests/integration/test_subcmd_json_output.py`). Full pytest passes 58 / 2 pre-existing skips.

Stats

Pull requests: #14 (feature content, 16 files / +1994 / -1177) and #15 (version bump fix, 1 file / +1 / -1).

Install

```bash
pip install --pre memexa==0.1.0rc3
memexa demo
```

🤖 Generated with Claude Code

Assets 2
Loading