feat: initial release of aimemo v0.3.0

Zero-dependency MCP memory server for AI agents.
SQLite+FTS5 storage, JSON-RPC 2.0 MCP stdio server,
Cobra CLI with 18 commands, append-only journal.
Supports Claude Code, Cursor, Windsurf, Codex, Cline, Continue, Zed.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: Panda

.github/workflows/release.yml

@@ -0,0 +1,29 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  goreleaser:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-go@v5
+        with:
+          go-version-file: go.mod
+
+      - uses: goreleaser/goreleaser-action@v6
+        with:
+          version: latest
+          args: release --clean
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          GITHUB_OWNER: MyAgentHubs
+          HOMEBREW_TAP_GITHUB_TOKEN: ${{ secrets.HOMEBREW_TAP_GITHUB_TOKEN }}

.gitignore

@@ -0,0 +1,13 @@
+# Build output
+/aimemo
+dist/
+
+# Local test db
+.aimemo/
+
+# macOS
+.DS_Store
+
+# Go
+*.test
+*.out

.goreleaser.yaml

@@ -0,0 +1,46 @@
+version: 2
+
+builds:
+  - id: aimemo
+    main: ./cmd/aimemo
+    binary: aimemo
+    env:
+      - CGO_ENABLED=0
+    goos: [linux, darwin, windows]
+    goarch: [amd64, arm64]
+    ignore:
+      - goos: windows
+        goarch: arm64
+    ldflags:
+      - -s -w
+      - -X main.version={{.Version}}
+
+archives:
+  - formats: [tar.gz]
+    format_overrides:
+      - goos: windows
+        formats: [zip]
+    name_template: "aimemo_{{.Version}}_{{.Os}}_{{.Arch}}"
+
+brews:
+  - name: aimemo
+    repository:
+      owner: "{{ .Env.GITHUB_OWNER }}"
+      name: homebrew-tap
+      token: "{{ .Env.HOMEBREW_TAP_GITHUB_TOKEN }}"
+    homepage: "https://github.com/{{ .Env.GITHUB_OWNER }}/aimemo"
+    description: "Zero-dependency MCP memory server for AI agents"
+    license: MIT
+    test: |
+      system "#{bin}/aimemo --version"
+    install: |
+      bin.install "aimemo"
+      generate_completions_from_executable(bin/"aimemo", "completion")
+
+checksum:
+  name_template: "checksums.txt"
+
+changelog:
+  sort: asc
+  filters:
+    exclude: ["^docs:", "^test:", "Merge pull request"]

.mcp.json

@@ -0,0 +1,10 @@
+{
+  "mcpServers": {
+    "aimemo-memory": {
+      "command": "aimemo",
+      "args": [
+        "serve"
+      ]
+    }
+  }
+}

CLAUDE.md

@@ -0,0 +1,23 @@
+# aimemo Memory Instructions
+
+## Session Start
+At the beginning of every session, call `memory_context` to load project context before doing any work.
+
+## During the Session
+Call `memory_store` (entities mode) when you:
+- Learn something new about the codebase architecture or design decisions
+- Fix a bug or identify a root cause
+- Make a significant implementation choice
+
+Call `memory_store` (journal mode) when you:
+- Complete a meaningful unit of work
+- Encounter and resolve a non-obvious problem
+
+## Session End
+Before the session ends, write a journal entry summarizing what was done:
+```
+memory_store({ journal: "..." })
+```
+
+## Search Before Asking
+Before asking the user to re-explain something, call `memory_search` first.

CONTRIBUTING.md

@@ -0,0 +1,43 @@
+# Contributing to aimemo
+
+## Prerequisites
+
+- Go 1.21+
+- No CGO required (`modernc.org/sqlite` is pure Go)
+
+## Running Tests
+
+```bash
+go test ./...
+```
+
+## Building
+
+```bash
+go build -o aimemo ./cmd/aimemo
+```
+
+## Project Structure
+
+```
+cmd/aimemo/         # Binary entry point
+internal/
+  cli/              # Cobra commands
+  config/           # TOML config loader
+  db/               # SQLite layer (entities, observations, relations, journal, search)
+  locate/           # .aimemo directory discovery
+  mcp/              # MCP stdio server (JSON-RPC 2.0)
+examples/           # CLAUDE.md templates for users
+```
+
+## Making Changes
+
+1. Fork the repo and create a branch from `main`
+2. Make your changes with tests where applicable
+3. Run `go test ./...` — all tests must pass
+4. Submit a pull request with a clear description of the change
+
+## Reporting Issues
+
+Open a GitHub Issue. For security vulnerabilities, please email the maintainers
+directly rather than opening a public issue.

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MyAgentHubs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.