memax-cli 0.1.1-alpha.1953 → 0.1.1-alpha.1955

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MemaxLabs, Inc.
+
+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.

package/README.md

@@ -0,0 +1,98 @@
+<p align="center">
+  <a href="https://memax.app">
+    <img src="https://memax.app/images/memax-wordmark.svg" alt="Memax" width="200" />
+  </a>
+</p>
+
+<p align="center">
+  <strong>Persistent memory and context for AI agents — from the terminal.</strong>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/memax-cli"><img src="https://img.shields.io/npm/v/memax-cli.svg" alt="npm version" /></a>
+  <a href="https://www.npmjs.com/package/memax-cli"><img src="https://img.shields.io/npm/dm/memax-cli.svg" alt="npm downloads" /></a>
+  <a href="https://memax.app"><img src="https://img.shields.io/badge/memax-app-7c3aed" alt="memax.app" /></a>
+  <a href="https://docs.memax.app"><img src="https://img.shields.io/badge/docs-memax.app-7c3aed" alt="docs.memax.app" /></a>
+</p>
+
+---
+
+Memax is the shared memory layer for you and your AI agents. Push knowledge once — notes, files, URLs, chat transcripts — and recall it from any agent, any session, any device. Ask grounded questions and get answers with citations from your own memory base.
+
+`memax-cli` is the command-line entry point. It ships the `memax` binary for terminal workflows and a local MCP server so Claude Code, Cursor, Codex, and any other MCP-aware agent can read and write your memory directly.
+
+## Install
+
+```bash
+npm install -g memax-cli
+```
+
+Or run once without installing:
+
+```bash
+npx memax-cli recall "jwt session rotation policy"
+```
+
+## Quick start
+
+```bash
+# One-time: log in via browser
+memax login
+
+# Remember something
+memax push "Never block on a live migration — always do online + backfill."
+
+# Recall with natural language
+memax recall "migration guidelines"
+
+# Ask a grounded question — answer includes citations
+memax ask "How do we handle breaking schema changes?"
+
+# Wire up your IDE agent (writes an MCP entry to the right config file)
+memax setup
+```
+
+## What it does
+
+- **`memax push`** — save a thought, file, URL, or piped stdin
+- **`memax recall`** — natural-language search across personal + team knowledge
+- **`memax ask`** — AI-synthesized answer grounded in your memory, with citations
+- **`memax list` / `show` / `delete`** — browse and manage entries
+- **`memax hub`** — create, invite, and switch between team hubs
+- **`memax topic`** — inspect auto-generated topic clusters
+- **`memax dreams`** — view the ingestion/organization pipeline status
+- **`memax agents sync`** — device-aware sync of agent configs and session artifacts
+- **`memax import <dir>`** — one-way ingest of a directory into memory
+- **`memax mcp serve`** — start a local MCP server for agent integration
+- **`memax setup`** — detect installed agents and wire up MCP + hooks
+- **`memax hook`** — Claude Code hook for automatic context injection
+
+Run `memax --help` or `memax <command> --help` for the full surface.
+
+## Agent integration
+
+Memax is built agent-first. Three integration paths:
+
+1. **MCP (recommended for IDE agents)** — `memax setup` writes the right MCP server entry for Claude Code, Cursor, Codex, or Windsurf. The agent can then call `memax_recall`, `memax_push`, `memax_ask`, and friends directly.
+2. **Claude Code hooks** — automatic context injection before each prompt (`memax hook`). Latency budget is under 500ms; context is injected as `<memax-context>` blocks.
+3. **Direct CLI piping** — works with any agent and in CI. `memax recall … | your-agent`.
+
+## Configuration
+
+The CLI reads from `~/.memax/config.json` after first login. For CI and non-interactive use:
+
+```bash
+export MEMAX_API_KEY="mk_live_..."   # from memax.app → Settings → API Keys
+export MEMAX_API_URL="https://api.memax.app"   # default; override for self-hosted
+```
+
+## Links
+
+- **Product** — [memax.app](https://memax.app)
+- **Docs** — [docs.memax.app](https://docs.memax.app)
+- **SDK** — [`memax-sdk`](https://www.npmjs.com/package/memax-sdk)
+- **Source** — we're preparing the monorepo for open source; the repository at `github.com/MemaxLabs/memax` is currently private. Follow [@memaxapp](https://memax.app) or email [support@memax.app](mailto:support@memax.app) if you'd like early notice.
+
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/package.json

@@ -1,7 +1,19 @@
 {
   "name": "memax-cli",
-  "version": "0.1.1-alpha.1953",
+  "publishConfig": {
+    "access": "public"
+  },
+  "version": "0.1.1-alpha.1955",
   "description": "CLI for Memax — universal context & memory hub for AI agents",
+  "homepage": "https://memax.app",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MemaxLabs/memax.git",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "email": "support@memax.app"
+  },
   "type": "module",
   "bin": {
     "memax": "./dist/index.js"
@@ -16,7 +28,7 @@
     "@modelcontextprotocol/sdk": "^1.12.1",
     "chalk": "^5.4.0",
     "commander": "^13.0.0",
-    "memax-sdk": "^0.4.0-alpha.1953"
+    "memax-sdk": "^0.4.0-alpha.1955"
   },
   "devDependencies": {
     "@types/node": "^25.5.0",
@@ -36,7 +48,7 @@
     "dist",
     "assets"
   ],
-  "license": "UNLICENSED",
+  "license": "MIT",
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",