# Noēsis

> Noēsis is a lightweight cognitive control layer for agent workflows with auditable episodes and optional policy enforcement.

## Docs

- [Artifacts](https://docs.noesis.systems/explanation/artifacts.md): Understanding the files Noēsis produces: summary.json, state.json, events.jsonl, and more.
- [The cognitive loop](https://docs.noesis.systems/explanation/cognitive-loop.md): Understanding the phase sequence that makes Noēsis episodes observable and auditable.
- [Core concepts](https://docs.noesis.systems/explanation/core-concepts.md): Understand the fundamental building blocks of Noēsis: episodes, faculties, and artifacts.
- [Determinism and replay](https://docs.noesis.systems/explanation/determinism.md): Make episodes reproducible for debugging, evals, and compliance.
- [Faculties](https://docs.noesis.systems/explanation/faculties.md): Understanding the four cognitive faculties: Intuition, Direction, Governance, and Insight.
- [Prompt provenance](https://docs.noesis.systems/explanation/prompt-provenance.md): How Noēsis records prompt provenance and how to control it.
- [Add a memory port](https://docs.noesis.systems/guides/add-memory-port.md): Plug long-term memory into Noēsis using SQLite, your DB, or a custom store.
- [Adopting Noēsis in real systems](https://docs.noesis.systems/guides/adopting-noesis.md): Move from local traces to team-wide observability and evals without surprises.
- [Configure planner modes](https://docs.noesis.systems/guides/configure-planner-modes.md): How to toggle between meta and minimal planner modes for different governance levels.
- [Configure shared episode storage](https://docs.noesis.systems/guides/configure-shared-storage.md): Point Noēsis at a shared location via network volumes, S3 sync, Docker mounts, or Kubernetes PVCs.
- [Export metrics](https://docs.noesis.systems/guides/export-metrics.md): How to send Noēsis insight metrics to your observability stack.
- [Human-in-the-loop](https://docs.noesis.systems/guides/human-in-the-loop.md): How to add human approval workflows to your Noēsis episodes.
- [Integrate adapters](https://docs.noesis.systems/guides/integrate-adapters.md): How to connect Noēsis to LangGraph, CrewAI, or your own agent runtime.
- [Write intuition policies](https://docs.noesis.systems/guides/write-policies.md): How to create, test, and deploy policies that guide and guard your agent episodes.
- [Noēsis](https://docs.noesis.systems/index.md): A lightweight Python cognitive framework for orchestrating and tracing agentic reasoning. Understanding, made observable.
- [Quickstart](https://docs.noesis.systems/quickstart.md): Get your first Noēsis episode running in under 5 minutes.
- [CLI reference](https://docs.noesis.systems/reference/cli.md): Command reference for the shipped Noēsis CLI entrypoint.
- [Configuration](https://docs.noesis.systems/reference/configuration.md): Complete reference for Noēsis configuration options.
- [Events schema](https://docs.noesis.systems/reference/events.md): Complete reference for Noēsis event types and their payloads.
- [Python API](https://docs.noesis.systems/reference/python-api.md): Complete reference for the Noēsis Python package.
- [State schema](https://docs.noesis.systems/reference/state.md): Complete reference for the Noēsis state.json artifact.
- [Summary schema](https://docs.noesis.systems/reference/summary.md): Complete reference for the Noēsis summary.json artifact.
- [Governed Side Effects: Action Candidates + Veto](https://docs.noesis.systems/tutorials/governed-side-effects.md): Use ns.governed_act to enforce governance at the side-effect boundary.
- [Hello Episode: See Your Agent Think in 5 Minutes](https://docs.noesis.systems/tutorials/hello-episode.md): Run a tiny agent through Noēsis, open the artifacts, and read the timeline that shows every phase.
- [LangGraph Episode: Trace the Cognitive Loop](https://docs.noesis.systems/tutorials/langgraph-episode.md): Run a LangGraph agent with Noesis and capture cognitive artifacts.
- [Trace-Based Evals: Score Safety & Success from Artifacts](https://docs.noesis.systems/tutorials/trace-based-evals.md): Score governed actions from Noesis traces—not just final answers.

## OpenAPI Specs

- [openapi](https://docs.noesis.systems/api-reference/openapi.json)

## Optional

- [GitHub](https://github.com/saraeloop/noesis)