CLI Reference
memax push
Push knowledge to your Memax hub. Accepts files, stdin, URLs, and directories.
Push content into your memory hub.
Usage
memax push [options]Options
| Flag | Short | Description | Default |
|---|---|---|---|
--file <path> | -f | File to push (repeatable, supports globs) | — |
--category <cat> | -c | Override auto-classification | Auto-detected |
--tags <tags> | Comma-separated tags | — | |
--boundary <level> | private, team, or public | private | |
--hub <id> | Target hub | Default hub | |
--title <title> | -t | Override auto-generated title | Auto-generated |
--hint <text> | Context hint for classifier | — | |
--snapshot | For URLs: capture full content | Link-only | |
--mode <mode> | auto, suggest, or confirm | suggest | |
--dry-run | Show what would be pushed | — | |
--force | Skip secret detection warnings | — |
Examples
Push a file
memax push --file ./ARCHITECTURE.md✓ Saved — "Architecture Overview" (core · private) [48ms]Push with metadata
memax push -f ./runbook.md \
--category reference \
--tags "ops,incidents" \
--boundary team \
--hint "on-call runbook for production incidents"Push from stdin
echo "We chose JWT for auth because of stateless verification" | memax push
cat meeting-notes.txt | memax push --category dailyPush multiple files
memax push -f ./docs/*.md
memax push -f ./src/auth.ts -f ./src/middleware.tsPush a URL
# Store as link reference (default)
memax push https://docs.google.com/document/d/1abc...
# Snapshot the full content
memax push https://example.com/pricing --snapshotDry run
memax push -f ./ARCHITECTURE.md --dry-runWould push:
Title: "Architecture Overview"
Category: core (confidence: 94%)
Boundary: private
Size: 2,847 bytes → 4 chunksClassification modes
| Mode | Behavior |
|---|---|
auto | Save immediately, no review |
suggest | Save immediately, show review hint (default) |
confirm | Interactive confirmation before saving |
Secret detection
Memax scans content for potential secrets (API keys, tokens, passwords) before pushing. If detected:
- In
suggest/automode: a warning is shown, push continues - In
confirmmode: you're asked to confirm - Use
--forceto skip secret detection