memu-cli 0.1.0__tar.gz

memu_cli-0.1.0/.claude/skills/memu/SKILL.md

@@ -0,0 +1,46 @@
+---
+name: memu
+description: Give this agent persistent memory via memU. Use to memorize (save files/folders so context survives this session) when the user asks to remember or sync something, or after completing work worth keeping; and to retrieve (search memory from earlier sessions) when the user asks what is known about a person/project/topic or references context not in this conversation.
+---
+
+# memU: memorize and retrieve persistent memory
+
+memU compiles sources into a persistent local store (`./data/memu.sqlite3` + a browsable `./data/memory/` markdown tree, relative to CWD). What one session memorizes, the next can retrieve — always run from the project root so every command hits the same store.
+
+Use only the two commands below. Do not use the legacy `memu memorize` / `memu retrieve` commands.
+
+Both directions need an API key: make sure `OPENAI_API_KEY` (or `MEMU_LLM_PROVIDER` + its matching key) is set, and tell the user if it is missing.
+
+## Locate the CLI
+
+Use the first available runner:
+
+1. `memu` (installed via `pip install memu-py`)
+2. `uvx --from memu-py memu`
+3. `npx memu-cli`
+
+## Memorize
+
+```bash
+memu memorize-workspace <folder>
+```
+
+- Incremental and safe to re-run: diffs against `<folder>/.memu_manifest.json`, so only added/modified files are processed and memory from deleted files is removed.
+- Top-level directory decides the treatment: `chat/` → memory topics, `agent/` → skills, everything else → indexed workspace context (modality inferred per file from its extension).
+- To memorize a single file, place (or copy) it into the workspace folder and sync — there is no separate single-file path.
+
+Report the printed diff (added/modified/deleted) to the user; pass `--json` if you need to parse the result.
+
+## Retrieve
+
+```bash
+memu retrieve-workspace "<query>"
+```
+
+Single-shot embedding search, no LLM calls. Returns JSON in three layers:
+
+- `segments` — the matched slices, ranked by similarity (check `score`)
+- `files` — the memory/skill documents they belong to (usually what you want)
+- `resources` — matching raw sources, when summaries are not enough
+
+If a query misses, retry with different phrasing or more specific terms. Low scores across the board usually mean nothing relevant is stored — say so rather than stretching weak matches. You can also read `./data/memory/MEMORY.md` / `SKILL.md` / `INDEX.md` directly for a browsable overview.

memu_cli-0.1.0/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,75 @@
+name: Bug Report
+description: Report a bug or issue with memU
+title: "[BUG] "
+labels: ["bug"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to report a bug in memU! Please fill in the following details.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: A clear and detailed description of the bug.
+      placeholder: "Enter a clear and concise description of what the bug is."
+    validations:
+      required: true
+
+  - type: input
+    id: environment
+    attributes:
+      label: Environment
+      description: The environment where this bug occurred (e.g., operating system, CPU arch, etc.).
+      placeholder: "Enter details about the environment."
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to reproduce
+      description: What are the steps to reproduce this issue?
+      placeholder: "Enter step-by-step instructions to reproduce the issue."
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected behavior
+      description: What should have happened instead?
+      placeholder: "Describe what you expected to happen."
+    validations:
+      required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: Version
+      description: What version of memU are you using?
+      placeholder: e.g., v1.0.0
+    validations:
+      required: true
+
+  - type: dropdown
+    id: severity
+    attributes:
+      label: Severity
+      description: How severe is the bug?
+      options:
+        - Critical
+        - Major
+        - Minor
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional_info
+    attributes:
+      label: Additional Information
+      description: Any other context or screenshots related to the bug.
+      placeholder: "Enter additional context or information."
+    validations:
+      required: false

memu_cli-0.1.0/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+  - name: GitHub Discussions
+    url: https://github.com/NevaMind-AI/memU/discussions
+    about: For questions and general discussions about memU
+  - name: Documentation
+    url: https://github.com/NevaMind-AI/memU/blob/main/README.md
+    about: Check out the memU documentation

memu_cli-0.1.0/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,61 @@
+name: Feature Request
+description: Request a feature for memU
+title: "[FEATURE] "
+labels: ["enhancement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to request a feature for memU! Please fill in the following details.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: A clear and detailed description of the feature request.
+      placeholder: "Enter a clear and concise description of what the feature request is."
+    validations:
+      required: true
+
+  - type: textarea
+    id: motivation
+    attributes:
+      label: Motivation
+      description: Why do we need this feature? What problem does it solve?
+      placeholder: "Explain the use case and why this feature would be valuable."
+    validations:
+      required: true
+
+  - type: dropdown
+    id: platform
+    attributes:
+      label: Platform
+      description: Which platform(s) does this feature apply to?
+      options:
+        - Platform Independent
+        - Linux
+        - macOS
+        - Windows
+    validations:
+      required: true
+
+  - type: dropdown
+    id: priority
+    attributes:
+      label: Priority
+      description: How important is this feature?
+      options:
+        - Critical
+        - Major
+        - Minor
+    validations:
+      required: true
+
+  - type: textarea
+    id: additional_info
+    attributes:
+      label: Additional Information
+      description: Any other context or screenshots related to the feature request.
+      placeholder: "Enter additional context or information."
+    validations:
+      required: false

memu_cli-0.1.0/.github/ISSUE_TEMPLATE/hackathon_task.yml

@@ -0,0 +1,65 @@
+name: Hackathon Task
+description: The official designated task for the memU track in the 2026 New Year Challenge
+title: "[2026NewYearChallenge] "
+labels: ["hackathon-task"]
+assignees: []
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thank you for taking the time to join the challenge, and best of luck!
+
+  - type: dropdown
+    id: label_hint
+    attributes:
+      label: Label
+      description: Pick the most appropriate label for this task.
+      options:
+        - hackathon-task
+    validations:
+      required: true
+
+  - type: input
+    id: assignees_hint
+    attributes:
+      label: Assignees
+      description: GitHub usernames to assign (comma-separated). If empty, maintainers will triage.
+      placeholder: "e.g., alice,bob"
+    validations:
+      required: false
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description*
+      description: What will this task implement?
+      placeholder: "Enter a clear and concise description of the task you want to implement."
+    validations:
+      required: true
+
+  - type: textarea
+    id: requirements
+    attributes:
+      label: Requirements (optional)
+      description: What will your planned pull request include? (APIs, modules, tests, docs, etc.)
+      placeholder: |
+        - [ ] Implementation details
+        - [ ] Tests
+        - [ ] Docs / examples
+        - [ ] Compatibility notes
+    validations:
+      required: false
+
+  - type: textarea
+    id: review_criteria
+    attributes:
+      label: Review Criteria (optional)
+      description: How will this task be evaluated?
+      placeholder: |
+        Example:
+        - Correctness (passes tests, no regressions)
+        - Quality (readability, modularity)
+        - DX (good docs / examples)
+        - Impact (useful for memU users)
+    validations:
+      required: false

memu_cli-0.1.0/.github/ISSUE_TEMPLATE/improvement_suggestion.yml

@@ -0,0 +1,63 @@
+name: Improvement Suggestion
+description: Suggest an improvement for memU
+title: "[IMPROVEMENT] "
+labels: ["enhancement", "improvement"]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for taking the time to suggest an improvement for memU! Please fill in the following details.
+
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: A clear and detailed description of the improvement suggestion.
+      placeholder: "Enter a clear and concise description of what you'd like to improve."
+    validations:
+      required: true
+
+  - type: textarea
+    id: current_behavior
+    attributes:
+      label: Current Behavior
+      description: How does it work currently?
+      placeholder: "Describe the current behavior or implementation."
+    validations:
+      required: false
+
+  - type: textarea
+    id: proposed_improvement
+    attributes:
+      label: Proposed Improvement
+      description: How would you like it to work?
+      placeholder: "Describe your proposed improvement."
+    validations:
+      required: true
+
+  - type: textarea
+    id: benefits
+    attributes:
+      label: Benefits
+      description: What are the benefits of this improvement?
+      placeholder: "Explain why this improvement would be valuable."
+    validations:
+      required: false
+
+  - type: input
+    id: version
+    attributes:
+      label: Version
+      description: What version of memU are you using?
+      placeholder: e.g., v1.0.0
+    validations:
+      required: false
+
+  - type: textarea
+    id: additional_info
+    attributes:
+      label: Additional Information
+      description: Any other context or screenshots related to the improvement.
+      placeholder: "Enter additional context or information."
+    validations:
+      required: false

memu_cli-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,44 @@
+## 📝 Pull Request Summary
+
+Please provide a short summary explaining the purpose of this PR.
+
+---
+
+## ✅ What does this PR do?
+- Clearly describe the change introduced.
+- Mention the motivation or problem it solves.
+
+---
+
+## 🤔 Why is this change needed?
+- Explain the context or user impact.
+- Link any relevant issue or discussion.
+
+---
+
+## 🔍 Type of Change
+Please check what applies:
+
+- [ ] Bug fix
+- [ ] New feature
+- [ ] Documentation update
+- [ ] Refactor / cleanup
+- [ ] Other (please explain)
+
+---
+
+## ✅ PR Quality Checklist
+
+- [ ] PR title follows an allowed format (for example `feat:`, `fix:`, `docs:`, `memory base:`)
+- [ ] Changes are limited in scope and easy to review
+- [ ] Documentation updated where applicable
+- [ ] No breaking changes (or clearly documented)
+- [ ] Related issues or discussions linked
+
+---
+
+## 📌 Optional
+
+- [ ] Screenshots or examples added (if applicable)
+- [ ] Edge cases considered
+- [ ] Follow-up tasks mentioned

memu_cli-0.1.0/.github/workflows/build.yml

@@ -0,0 +1,35 @@
+name: build
+
+on: [push, pull_request]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    if: github.event_name != 'pull_request' || github.event.pull_request.head.repo.full_name != github.event.pull_request.base.repo.full_name
+    strategy:
+      matrix:
+        python-version: ["3.13"]
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install uv & set Python
+        uses: astral-sh/setup-uv@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+          enable-cache: true
+          cache-python: true
+
+      - name: Ensure Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Sync dependencies
+        run: |
+          uv sync --frozen --extra document
+          uv run pre-commit install
+
+      - name: Run style checks
+        run: uv run make check
+
+      - name: Run tests
+        run: uv run make test

memu_cli-0.1.0/.github/workflows/pr-title.yml

@@ -0,0 +1,47 @@
+name: pr-title
+
+on:
+  pull_request_target:
+    types:
+      - opened
+      - edited
+      - reopened
+      - synchronize
+
+permissions:
+  contents: read
+  statuses: write
+
+jobs:
+  validate:
+    name: Validate PR title
+    runs-on: ubuntu-latest
+    steps:
+      - uses: amannn/action-semantic-pull-request@v6
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          headerPattern: '^([\w ]*)(?:\(([\w$.\-*/ ]*)\))?: (.*)$'
+          headerPatternCorrespondence: type, scope, subject
+          types: |
+            build
+            chore
+            ci
+            docs
+            feat
+            fix
+            memory base
+            perf
+            refactor
+            revert
+            style
+            test
+      - name: Disallow trailing ellipsis
+        shell: bash
+        env:
+          PR_TITLE: ${{ github.event.pull_request.title }}
+        run: |
+          if [[ "$PR_TITLE" == *... ]]; then
+            echo "::error title=Invalid PR title::PR title must not end with an ellipsis (...)"
+            exit 1
+          fi

memu_cli-0.1.0/.github/workflows/release-please.yml

@@ -0,0 +1,160 @@
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+  issues: write
+  pull-requests: write
+
+name: release-please
+
+jobs:
+  release-please:
+    runs-on: ubuntu-latest
+    outputs:
+      releases_created: ${{ steps.release.outputs.releases_created }}
+      tag_name: ${{ steps.release.outputs.tag_name }}
+    steps:
+      - uses: googleapis/release-please-action@v4
+        id: release
+        with:
+          release-type: python
+          target-branch: main
+
+  build-wheels:
+    name: build wheels (${{ matrix.label }})
+    runs-on: ${{ matrix.os }}
+    needs: release-please
+    if: ${{ needs.release-please.outputs.releases_created == 'true' && needs.release-please.outputs.tag_name != '' }}
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - os: ubuntu-latest
+            label: linux-x86_64
+            target: x86_64-unknown-linux-gnu
+            extra-args: "--compatibility manylinux_2_39"
+            python-version: "3.13"
+          - os: ubuntu-latest
+            label: linux-aarch64
+            target: aarch64-unknown-linux-gnu
+            extra-args: "--compatibility manylinux_2_39"
+            python-version: "3.13"
+          - os: macos-15-intel
+            label: macos-x86_64
+            target: ""
+            extra-args: ""
+            python-version: "3.13"
+          - os: macos-latest
+            label: macos-aarch64
+            target: ""
+            extra-args: ""
+            python-version: "3.13"
+          - os: windows-latest
+            label: windows-x86_64
+            target: ""
+            extra-args: ""
+            python-version: "3.13"
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install maturin
+        run: uv tool install maturin
+
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: ${{ matrix.target }}
+
+      - name: Setup cross-compilation for Linux ARM64
+        if: matrix.label == 'linux-aarch64'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y gcc-aarch64-linux-gnu g++-aarch64-linux-gnu
+
+      - name: Build wheel
+        run: uvx maturin build --release --out dist ${{ matrix.extra-args }} ${{ matrix.target && format('--target {0}', matrix.target) || '' }}
+        env:
+          CARGO_TARGET_AARCH64_UNKNOWN_LINUX_GNU_LINKER: aarch64-linux-gnu-gcc
+
+      - name: Upload wheel artifact
+        uses: actions/upload-artifact@v6
+        with:
+          name: wheels-${{ matrix.label }}
+          path: dist/*.whl
+          if-no-files-found: error
+
+  build-sdist:
+    name: build sdist
+    runs-on: ubuntu-latest
+    needs: release-please
+    if: ${{ needs.release-please.outputs.releases_created == 'true' && needs.release-please.outputs.tag_name != '' }}
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v7
+        with:
+          python-version: "3.13"
+
+      - name: Setup Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - name: Install maturin
+        run: uv tool install maturin
+
+      - name: Build sdist
+        run: uvx maturin sdist --out dist
+
+      - name: Upload sdist artifact
+        uses: actions/upload-artifact@v6
+        with:
+          name: sdist
+          path: dist/*.tar.gz
+          if-no-files-found: error
+
+  publish:
+    name: publish release artifacts
+    runs-on: ubuntu-latest
+    needs:
+      - release-please
+      - build-wheels
+      - build-sdist
+    if: ${{ needs.release-please.outputs.releases_created == 'true' && needs.release-please.outputs.tag_name != '' }}
+    environment: pypi
+    permissions:
+      id-token: write
+      contents: write
+    steps:
+      - name: Download wheel artifacts
+        uses: actions/download-artifact@v7
+        with:
+          pattern: wheels-*
+          merge-multiple: true
+          path: dist
+
+      - name: Download sdist artifact
+        uses: actions/download-artifact@v7
+        with:
+          name: sdist
+          path: dist
+
+      - name: Upload binaries to release
+        uses: svenstaro/upload-release-action@v2
+        with:
+          repo_token: ${{ secrets.GITHUB_TOKEN }}
+          file: dist/*
+          tag: ${{ needs.release-please.outputs.tag_name }}
+          file_glob: true
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          packages-dir: dist/