inform

Corpus Management & Orchestration
Orchestrate corpus maintenance with automated fetch/extract and package/index workflows. Keep configuration in git while documents live on shared mounts for multi-agent collaboration.
[opencode-docs] βœ“ Pulled 15 files (24KB)
[hyphn-skills] βœ“ Pulled 8 files (12KB)
[framework-api] ⏳ Fetching...
[corpus status] 3/4 sources synced β€’ 0 errors

Background Corpus Management

Automate external knowledge base maintenance

πŸ”„

Automated Orchestration

Coordinates fetch/extract (inform) and package/index (catalog) workflows for seamless corpus updates. Perfect for hooks and background automation.

πŸ“‚

Git-Friendly Configuration

Keep corpus configuration and manifests in git. Track your sources and metadata while actual documents live on shared mounts for team collaboration.

βš™οΈ

Configurable Timeouts

Prevent hanging on problematic sources with per-source timeout configuration, retry limits, and continue-on-error behavior.

πŸ“Š

Error Logging

Comprehensive error tracking with detailed logs written to ~/.hyphn/logs/inform-sync.log for debugging and monitoring.

🎯

Multi-Agent Sharing

Share corpora across multiple agents via shared mounts. Configuration in git, content on external storageβ€”best of both worlds.

πŸ”§

Flexible Phasing

Run specific phases with --only pull|index|export for granular control over corpus updates.

Orchestration Workflow

Inform coordinates corpus maintenance across multiple sources

πŸ“₯

Fetch/Extract

Inform pulls from sources
Writes to corpus content

πŸ“‹

Package/Index

Catalog processes content
Writes indexed artifacts

πŸ“Š

Manifests

Update configuration
Commit to git

# Complete corpus sync
inform sync --all --mirror --print-cmds

# Status check
inform status

Installation

Set up corpus management

πŸ“¦

Bun Package

# Install dependencies bun install # Run inform directly bun run packages/inform/src/index.ts sync --all

Run from monorepo for full ecosystem access

Quick Start

Get your corpus configured and syncing

βš™οΈ

Initialize Configuration

# Create corpus.yml template bun run packages/inform/src/index.ts init # Edit .fwdslsh/corpus/corpus.yml # Add your sources and settings
πŸ”„

Sync Corpus

# Sync all sources with mirroring inform sync --all --mirror --print-cmds # Check status inform status

External vs Internal Knowledge

Inform manages external docs, Reflect manages internal history

🌐

inform (External)

Manages system's external knowledge base: documentation, APIs, tutorials fetched from external sources. Updates source info, catalogs content, handles cleaning.

πŸ“

reflect (Internal)

Focuses on system history to create and curate internal knowledge base from previous experiences, learnings, and session outcomes.

Advanced Configuration

Fine-tune timeouts and error handling

⏱️

Timeout Configuration

FWD_CORPUS_TIMEOUT=600000

Per-source timeout in milliseconds (default: 5 minutes)

πŸ”„

Retry Strategy

FWD_CORPUS_RETRIES=3

Maximum retry attempts per source (default: 2)

⚠️

Error Handling

FWD_CORPUS_CONTINUE_ON_ERROR=false

Continue syncing other sources if one fails (default: true)

# Strict sync with short timeout
FWD_CORPUS_TIMEOUT=60000 FWD_CORPUS_CONTINUE_ON_ERROR=false inform sync

# Lenient sync with extended timeout
FWD_CORPUS_TIMEOUT=600000 FWD_CORPUS_RETRIES=3 inform sync

Environment Variables

Configure behavior via environment

FWDSLH_CORPUS_PATH
Corpus directory (default: ~/.fwdslsh/corpus)
FWD_CORPUS_TIMEOUT
Per-source timeout (ms, default: 300000)
FWD_CORPUS_RETRIES
Retry attempts (default: 2)
FWD_CORPUS_CONTINUE_ON_ERROR
Continue on error (default: true)

Ready to Automate Corpus Management?

Keep your external knowledge base fresh with automated workflows