damiansire GitHub avatar

cognitive-substrate-os

damiansire

Cognitive Substrate is a lightweight, local, filesystem-first agentic task runner that uses Google Gemini to decompose goals into tasks, execute them in a sandboxed environment, verify results, and persist all state as human-editable markdown files.

Stars

28

7-day growth

No data

Forks

1

Open issues

0

License

MIT

Last updated

2026-07-17

AI repository intelligence
FR-AI / ANALYSIS

Why it is worth attention

It stands out for its radical transparency—every piece of state is a plain file you can read and edit—combined with a practical eval harness, self-improvement loop, governance, and multi-worker coordination, making agentic workflows auditable and trustable.

Who it is for

  • Developers building agentic systems
  • Researchers exploring transparent AI agents
  • DevOps engineers needing auditable task automation
  • Hobbyists experimenting with local, filesystem-first agent workflows

Use cases

  • Automating complex multi-step tasks with deterministic verification
  • Running long-horizon agent capability evaluations and regression tests
  • Creating auditable, version-controlled agent runs for compliance
  • Coordinating multiple agents across machines with task claiming

Strengths

  • Filesystem-first state: all state is readable/writable markdown, no opaque databases
  • Sandboxed execution: opt-in container isolation and WASM sandbox for JS snippets
  • Comprehensive eval harness with pass@1, time-to-pass, and cost-to-pass metrics
  • Governance with approval gate, per-task budgets, and append-only audit log

Considerations

  • Native shell sandbox is not a security boundary; container isolation is opt-in
  • OpenAI adapter is implemented but not yet verified against the real OpenAI API
  • Roadmap features like desktop automation and full UX doctrine are not yet built

README quick start

Getting Started

Description

A lightweight, local, filesystem-first agentic task runner built in TypeScript and powered by Google Gemini

Related repositories

Similar projects matched by category, topics, and programming language.

TanStack
Featured
TanStack GitHub avatar

router

TanStack Router is a type-safe, data-driven React router with built-in caching, prefetching, and nested layouts, while TanStack Start extends it into a full-stack SSR framework.

Web DevelopmentFrontend Frameworks
14,861
vercel-labs
Featured
vercel-labs GitHub avatar

scriptc

scriptc compiles ordinary TypeScript into small, fast native executables without needing Node.js, V8, or any JavaScript runtime in the binary.

Developer ToolsCode Quality & Build
1,985
Jakubantalik
Featured
Jakubantalik GitHub avatar

thinking-orbs

A React component library that renders six hand-tuned animated thought orb loading indicators on a plain 2D canvas, with two purpose-tuned sizes and automatic theme detection for AI and agent UIs.

AI & Machine LearningAI Agents
1,191