bash

A command-line interface for Zengram, a shared memory system used by terminal-based agents and scripts.

In plain words
What is it for?
Use it to store, search, summarize, and retrieve shared memories from a terminal.
Why use it?
It lets agents save and retrieve knowledge across sessions instead of losing it when a task ends.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/zensystemai/zengram/bash
Any agent
npx skills add ZenSystemAI/Zengram --skill bash
Clone the repo
git clone --depth 1 https://github.com/ZenSystemAI/Zengram

Made for: Claude Code, Codex.

Per session 0 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 958 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00000 $0.00958
Opus 5 $0.00000 $0.00479
Sonnet 5 $0.00000 $0.00192
Haiku 4.5 $0.00000 $0.00096

Measured 2d ago against content hash fbf95a43d2b9, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

bash scanned grade A with 1 finding against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

The scan reads SKILL.md. This mod also ships 1 executable file (brain.sh), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

> This adapter covers 6 of the 13 Zengram tools (store, search, briefing, query, stats, consolidate). The remaining 7 (entities, delete, update, export, import, reflect, research) are reachable directly over REST with `c
adapters/bash/SKILL.md · 100 lines

How it starts

The opening of the file, as written. The whole thing — 100 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Shared Brain — Bash CLI Adapter

Command-line interface for the Zengram system. Use this to store, search, and retrieve shared memories from any terminal-based agent or script.

This adapter covers 6 of the 13 Zengram tools (store, search, briefing, query, stats, consolidate). The remaining 7 (entities, delete, update, export, import, reflect, research) are reachable directly over REST with curl — see examples/curl-demo.sh. Prefer curl over adding new subcommands here.

Requirements

  • curl and jq must be installed
  • Set BRAIN_API_KEY as an environment variable, or place it in $HOME/.config/zengram/.env

Configuration

Variable Default Description
BRAIN_API_URL http://localhost:8084 API server URL
BRAIN_AGENT_NAME my-agent Persisted as every write's source_agent AND used as the briefing self-exclusion filter. Set a stable, unique name per agent — briefings, filters, and cross-agent corroboration key off it.
BRAIN_API_KEY (required) API key for authentication
BRAIN_ENV_FILE $HOME/.config/zengram/.env Path to env file

Commands

Store a memory

./brain.sh store \
  --type "fact" \
  --content "acme-corp prefers formal tone in all communications" \
  --client_id "acme-corp" \
  --category "semantic" \
  --importance "high"

Parameters:

  • --type (required): event | fact | decision | status
  • --content (required): The memory content
  • --client_id: Client/project slug or global (default: global)
  • --category: semantic | episodic | procedural (default: episodic)
  • --importance: critical | high | medium | low (default: medium)
  • --key: Unique key for facts (enables upsert — new facts with the same key supersede old ones)
  • --subject: Subject for status updates (enables upsert by subject)
  • --status_value: Current status string (for status type)

Semantic search

./brain.sh search \
  --query "client tone preferences" \
  --client_id "acme-corp" \
  --limit 5

Read the full file on GitHub · 100 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 100 lines · 0 tokens per session scan A fbf95a43d2b9

Subscribe to this mod's changes

bash is a skill published in the GitHub repository ZenSystemAI/Zengram (60 stars, last pushed 10d ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 958 tokens. A static security scan graded it A with 1 finding (makes network calls). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

skill-compact

Analyze, deduplicate, and restructure agent skills to follow agentskills.io best practices. Merges duplicate skills, extracts shared content into references, reduces SKILL.md sizes, and tracks original sources for update-then-recompact workflows. Use when the user mentions "compact skills", "deduplicate skills"…

JuanJoseGonGi/skill-compact · 103 tokens

skill-beta

Another sample skill for testing. Use when the user wants to create widgets with advanced features or mentions beta testing.

JuanJoseGonGi/skill-compact · 25 tokens

skill-alpha

A sample skill for testing. Use when the user mentions alpha testing, widget creation, or component design patterns.

JuanJoseGonGi/skill-compact · 25 tokens

skill-gamma

A completely different skill for database operations. Use when working with PostgreSQL queries, schema design, or database migrations.

JuanJoseGonGi/skill-compact · 27 tokens

etsy-category-listing

Etsy category page scraper: given an Etsy category URL (e.g. https://www.etsy.com/c/jewelry) and optional page number, returns paginated product listings with listingId, shopId, title, url, image, salePrice, originalPrice, currency, rating, reviewCount, shopName, isAd, freeShipping, badge from category and subcategory…

browser-act/skills · 209 tokens

human-approval

Request human approval before performing a SAFETY-CRITICAL, IRREVERSIBLE, or SCOPE-EXPANDING action — submit a structured context (action, scope, risk, consequence) plus options, then STOP the current turn. The platform redispatches the agent after the human decides. NEVER use for routine deliverables (writing docs /…

Prismer-AI/PrismerCloud · 168 tokens