Using BetterContext Copy

Ingestion Pipelines

Stream codebases, documentation, wikis, and event logs into your memory graph with automated AST extraction and causal dependency linking.

BetterContext provides multiple ingestion pathways tailored for initial repository bootstrapping, continuous git branch synchronization, and automated enterprise webhooks.

Ingestion Pathways

CLI Batch Ingest

Point the CLI at any local or remote git folder for instant parallelized AST indexing.

Webhook Streaming

Configure GitHub or Linear webhooks to incrementally parse merged commits and closed tickets.

REST Ingestion API

Programmatically upsert facts, customer schemas, and runbooks via SDK or cURL.

CLI Ingestion

The fastest way to index a project:

# Ingest the entire current directory on the 'main' branch
bettercontext ingest . \
  --branch main \
  --include "*.py,*.ts,*.md" \
  --exclude "tests/*,dist/*" \
  --threads 8

Programmatic Ingestion via Python SDK

Ingest custom documents with role-based ACLs and metadata:

from bettercontext import BetterContextClient

client = BetterContextClient()

# Upsert a sensitive architectural decision record
doc = client.memory.upsert(
    title="ADR-042: Database Encryption at Rest",
    content="All customer PII and authentication tokens must be stored in Postgres columns encrypted with pgcrypto.",
    format="markdown",
    tags=["security", "compliance", "database"],
    acls={
        "read": ["engineer", "security-lead", "admin"],
        "write": ["security-lead"]
    }
)

print(f"Created Node ID: {doc.node_id}")
print(f"Entities Extracted: {doc.extracted_entities}")

Handling Deletions & Tombstoning

When code or documentation is deleted in git, BetterContext uses Dual-Clock Tombstoning. Rather than instantly obliterating the node and breaking downstream historical queries, the node is marked as deprecated for current queries while remaining queryable during historical git-bisect and retrospective sessions.

Next Steps

Was this page helpful?

ON THIS PAGE

Overview
Ingestion Pathways
CLI Ingestion
Python SDK Example
Deletions & Tombstoning
Next Steps