memax-cli

library0.1.2jsnpmunverified

Universal context and memory hub CLI designed for AI agents, currently at v0.1.2. Provides persistent memory, inter-agent context sharing, and role-based context injection for AI assistants like Claude Code. Key differentiators: integrates with LLM-powered workflows via JSON commands, supports dynamic memory retrieval, and offers both authentication and session-based memory management. Actively developed with a focus on agent-to-agent communication.

llm-agents database auth-security

npm install memax-cli

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · MEMAX-CLI

memax-cli

llm-agentsjavascriptv0.1.2

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default

✓ import memax from 'memax-cli'

✗ const memax = require('memax-cli')

ESM-only; CJS require will fail

MemaxClient

✓ import { MemaxClient } from 'memax-cli'

✗ import MemaxClient from 'memax-cli'

Named export, not default

✓ import { login } from 'memax-cli'

✗ import login from 'memax-cli'

Named export; used for authentication

Initializes the Memax client, sets and retrieves context, shares context with another agent, and searches memory.

import { MemaxClient } from 'memax-cli'; const client = new MemaxClient({ apiKey: process.env.MEMAX_API_KEY ?? '', session: 'my-session' }); await client.setContext('user', { name: 'Alice', mood: 'curious' }); const ctx = await client.getContext('user'); console.log(ctx); await client.shareContext('agent-2', ['user']); const search = await client.searchMemory('curious'); console.log(search);

memax --version

Debug

Known issues

breakingAPI versioning: requests without Accept header default to v1, but future versions may break

fix

Always set Accept: application/vnd.memax.v2+json in requests when upgrading

affects: <0.2.0

deprecatedsetContext parameter now requires object, not string; v0.1.0 accepted strings

fix

Wrap string values in an object: { value: 'mystring' }

affects: 0.1.0 - 0.1.1

gotchaMemory search may return stale results due to eventual consistency (up to 2s delay)

fix

Wait 2 seconds after setContext or use the 'immediate' mode: { consistency: 'strong' }

affects: >=0.1.0

Errors

Common errors & fixes

Error: Cannot find module 'memax-cli'

Missing peer dependency node-fetch or incorrect Node.js version (<14)

fix

npm install node-fetch@2 and ensure Node >=14

TypeError: memax is not a function

Using default import instead of named import

fix

Use import { MemaxClient } from 'memax-cli'

UnhandledPromiseRejection: 401 Unauthorized

Missing or invalid MEMAX_API_KEY environment variable

fix

Set MEMAX_API_KEY in environment or pass apiKey to constructor

Upgrade

Version history

0.1.2latest on npm

Audit

Dependencies

node-fetchoptionalHTTP requests for API communication

Agent activity

22 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/MemaxLabs/memax ↗

packagehttps://www.npmjs.com/package/memax-cli ↗

homepagehttps://memax.app ↗