ctxbin@1.3.2

v1.3.2

What's New

• CTXBIN_OK confirmation on save/delete — save and delete commands now emit a structured confirmation message to stderr on success, so agents can clearly distinguish a successful operation from a silent no-op.

CTXBIN_OK: ctx saved (my-project/main)
CTXBIN_OK: agent deleted (reviewer)
CTXBIN_OK: skill saved (fp-pack, --dir)

• CTXBIN_QUIET=1 — Set this environment variable to suppress CTXBIN_OK messages in automation pipelines where the confirmation is unnecessary.

Notes

• Confirmation is written to stderr only — stdout behavior is unchanged, so existing pipelines are not affected.
• The format mirrors the existing CTXBIN_ERR convention for easy parsing.

ctxbin@1.3.1

ctxbin v1.3.1

This patch release improves the bundled ctxbin help guide to reduce sandbox-related timeouts and make remote execution requirements clearer.

Highlights

• Added a top-level Sandbox/Network Policy (Important) section
• Added a Quick decision block for the most common execution paths
• Clarified that all remote ctx, agent, and skill save/load/list/delete commands require outbound HTTPS
• Made the retry rule explicit:
  • do not retry remote commands in a restricted sandbox after timeout, fetch failed, or CTXBIN_ERR NETWORK
  • switch immediately to an unrestricted or network-enabled environment
• Consolidated duplicated network guidance into a single section
• Split failure triage between:
  • npx package installation/network failures
  • CTXBIN_ERR NETWORK from the remote store API step
• Clarified launcher choice:
  • prefer pnpm exec ctxbin ... when ctxbin is already installed locally
  • use npx ctxbin ... when it is not installed
  • use npx --no-install ctxbin ... when installed locally and npx is preferred
• Strengthened the local-file fallback flow for offline or blocked environments

Notes

• This release focuses on help/documentation UX and packaged guidance
• No command semantics were changed
• Validation tests were updated to lock the new help output structure

ctxbin@1.3.0

ctxbin v1.3.0

Highlights

This release adds an opt-in raw passthrough mode for ctx values, designed for exact payload replication workflows (sync/migration), while keeping all default behavior unchanged.

New Features

• Added ctxbin ctx load --raw
  • Outputs the stored value exactly as-is (including metadata header when present).
• Added ctxbin ctx save --raw
  • Stores input exactly as provided (no metadata injection/update).

Behavior and Compatibility

• Default ctx save still injects metadata (savedAt, optional by).
• Default ctx load still strips metadata and prints body text.
• --raw is explicit opt-in and does not affect existing workflows.

Guardrails

• Added conflict validation for unsafe/ambiguous combinations:
  • --raw + --append (rejected)
  • --raw + --by (rejected)
  • --raw + --meta (rejected)
  • --raw + --dir (rejected)
• list/delete continue rejecting unsupported input flags, including --raw.

Safety Warning for Agent Flows

• --raw now emits CTXBIN_WARN by default to discourage accidental use in normal agent operations.
• Suppress in automation with:
  • CTXBIN_SUPPRESS_RAW_WARN=1 (also accepts true / yes)

Tests and Docs

• Added integration coverage for:
  • raw save/load exact roundtrip
  • default vs raw output differences
  • conflict flag errors
  • warning emission and suppression
• Updated design/spec and user docs (README, skill guide, docs pages) to reflect raw mode and safety guidance.

Changelog

• feat: add raw passthrough mode for ctx save/load (d48fdfe)

ctxbin@1.2.0

ctxbin v1.2.0

Release date: 2026-02-15

Added

• Automatic metadata injection for string-based saves (ctx, agent, and skill --value)
• New save --by <actor> flag to record the by metadata field
• New load --meta flag to show metadata together with the body

Changed

• Default load behavior remains backward-compatible: body-only output (metadata stripped)
• --append now merges metadata-stripped body content, then re-injects fresh metadata
• Stronger flag validation:
  • load / delete reject --by
  • list / delete reject --meta
• Updated help documentation in skills/ctxbin/SKILL.md for metadata usage

Compatibility

• Core CLI workflow is backward-compatible
• Raw Redis string values now include a metadata header format:
  • ctxbin-meta@1
  • {json metadata}
  • ---
  • (body)
• Any external tooling that parses stored raw values should strip metadata before reading body content
• skillpack / skillref formats are unchanged

Quality

• Expanded integration tests for metadata behavior (--meta, --by)
• Added validation tests for new flag constraints
• Strengthened list type-mapping tests
• Full test suite passing

ctxbin@1.1.2

ctxbin v1.1.2

Docs

• Add CTXBIN_ERR NETWORK troubleshooting to skill doc — Agents running in sandboxed or CI environments often hit network restrictions on first use. The bundled skill doc (SKILL.md)
  now includes a dedicated section explaining the cause and three remediation steps:

  a. Grant outbound HTTPS permission and retry
  b. Use npx --no-install to skip registry lookup
  c. Fall back to local file, upload later

ctxbin@1.1.1

ctxbin v1.1.1

Documentation

• Structured context format for agent handoffs: Added recommended markdown format with # summary, # decisions, # open, # next, and # risks sections to SKILL.md. This helps agents create more consistent and informative
  context for seamless handoffs.

ctxbin@1.1.0

ctxbin v1.1.0

Features

• Improved ctx key inference: Now uses package.json name field when available, falling back to folder name if no package.json exists. This provides more consistent keys across different cloned folder names.
• Mismatch warning: When package.json name differs from folder name, a CTXBIN_WARN message is printed to stderr (operation still succeeds).

Bug Fixes

• list output not visible in some environments: Added missing trailing newline to ctx list and skill list output.

Documentation

• Updated key inference documentation: All docs (README, SKILL.md, QuickStart, CtxCommands) now explain the package.json name priority with folder name fallback.
• Added explicit key examples: Documented how to use explicit keys when folder name differs or outside git repos.
• Restructured Quick Start: Prioritized AI agent workflow as the core usage pattern.
• Fixed internal navigation: Replaced external links with internal navigateTo for better in-app navigation.

ctxbin@1.0.1

ctxbin v1.0.1

Bug Fixes

• list output not visible in some environments: Added missing trailing newline to ctx list and skill list output. This fixes an issue where output was not displayed in certain terminal/npx configurations.

Documentation

• Clarified key inference: Explicitly documented that ctx keys are derived from the local folder name, not git remote URL. Added note explaining why (parsing remote URLs across different git services is fragile).
• Added explicit key examples: SKILL.md, QuickStart, and CtxCommands now include examples for using explicit keys when folder name differs or outside git repos.
• Restructured Quick Start: Prioritized AI agent workflow as the core usage pattern.
• Fixed internal navigation: Replaced external links with internal navigateTo for better in-app navigation.

ctxbin@1.0.0

ctxbin v1.0.0

First stable release of ctxbin - a minimal, deterministic CLI for AI agent context persistence using Upstash Redis.

Features

Context Management (ctx)

• Branch-scoped context storage with automatic key inference from git repo/branch
• Save, load, append, list, and delete operations
• Works seamlessly inside git repositories

Agent & Skill Storage

• agent: Store reusable agent role definitions
• skill: Store skill definitions as strings, skillpacks, or skillrefs

Skillpacks

• Bundle entire directories as tar.gz archives
• Deterministic packaging (sorted entries, normalized permissions)
• 7MB size limit for reliable storage

Skillrefs

• Reference skills directly from public GitHub repositories
• Pin to specific commits or track default branch
• Fetch on demand with size and security limits

Built-in Help

• npx ctxbin help - Quick access to usage guide
• Works without Redis configuration

Design Principles

• Agent-first: Non-interactive, no prompts, fail-fast with clear errors
• Deterministic: Explicit key-value storage, no inference or AI magic
• Minimal: Thin Redis HASH client, nothing more

Requirements

• Node.js 18+
• Upstash Redis account

Quick Start

npx ctxbin init                              # Configure credentials
npx ctxbin ctx save --value "context here"   # Save context
npx ctxbin ctx load                          # Load context
npx ctxbin help                              # View usage guide

ctxbin@0.1.3

ctxbin v0.1.3

Improvements

• Better error guidance: Missing config error now shows setup instructions
  CTXBIN_ERR INVALID_INPUT: missing CTXBIN_STORE_URL/CTXBIN_STORE_TOKEN and no ~/.ctxbin/config.json. Create a Redis database at https://upstash.com and run npx ctxbin init to
  configure.

Documentation

• Zero-setup agent workflow: Added simpler alternative to agent-addon setup
  "Run npx ctxbin skill load ctxbin, read the output, then save the current context."
• Agents can now self-discover usage without copying agent-addon.md

Internal

• Added test coverage for missing config error message