Circuit

Filesystem-Native Agent State Infrastructure

This circuit documents the pattern where agent state is managed as persistent, versioned, hierarchical file structures rather than ephemeral vector stores or chat logs.

This circuit begins one level above the execution layer, addressing the storage medium of agent state. While local-inference-baseline covers computation and inspectable-agent-operations covers visibility, none explicitly secure the persistence layer itself.

NeuronFS replaces vector memory with hierarchical directory structures and zero-byte files. This converts behavioral guardrails into deterministic OS-native operations.

GitAgent applies version control principles to agent logic and prompts. It treats agent evolution as a code-first operation rather than a procedural one.

Superset runs multiple CLI agents in parallel using isolated git worktrees. ClawWork manages parallel task sessions with local file persistence outside chat interfaces.

holaOS provides a persistent runtime environment for long-horizon workflows. It aggregates memory and tools into a single desktop application to maintain context across runs.

Paperclip introduces organizational primitives like budgets and approval gates into this file-based structure. It frames coordination as an organizational design problem rather than undifferentiated task running.

The circuit resists ephemeral chat logs and opaque vector databases. It avoids proprietary lock-in where state is trapped in cloud-hosted retrieval endpoints.

The circuit is complete when agent memory, logic, and constraints are auditable as filesystem artifacts without requiring external memory services.

Connections

  • Superset - provides orchestration layer using isolated git worktrees for parallel agent execution (Current · en)
  • holaOS - provides persistent runtime environment for long-horizon workflow continuity (Current · en)
  • NeuronFS - implements filesystem-native constraint engine replacing vector memory with directory structures (Current · en)
  • ClawWork - manages local file persistence and scoped configuration outside chat interfaces (Current · en)
  • GitAgent: Version Control for AI Agents - applies version control principles to agent logic, prompts, and model configurations (Current · en)
  • Missing connection: paperclip

Mediation note

Tooling: OpenRouter / qwen/qwen3.5-flash-02-23

Use: identified pattern across existing Currents, drafted Circuit synthesis from knowledge base

Human role: review, edit, and approve before publication

Limits: synthesis is a starting point; human judgment required on pattern boundaries and claims