# clai > A Clojure AI agent harness that shares one live JVM with you - [Page not found](https://charming-taffy-d953e6.netlify.app/404/): The page you're looking for doesn’t exist or has moved. Check the URL, use the navigation to browse sections, or return to the homepage. - [Privacy](https://charming-taffy-d953e6.netlify.app/privacy/): clai runs on your machine and keeps its data in your PostgreSQL. This page explains what leaves your machine and what does not. - [Blog](https://charming-taffy-d953e6.netlify.app/blog/): Notes on building and using clai: design decisions, the live-JVM model, and lessons from an agent harness that edits itself. - [Docs](https://charming-taffy-d953e6.netlify.app/docs/): Install clai, drive an agent from the REPL or browser, configure models and providers, and read the reference for tools, hooks, and the HTTP API. ## Blog > Notes on building and using clai: design decisions, the live-JVM model, and lessons from an agent harness that edits itself. - [Why clai Runs the Agent in Your Own JVM](https://charming-taffy-d953e6.netlify.app/blog/why-clai-runs-the-agent-in-your-own-jvm/): Most agent harnesses put the model behind a process boundary. clai removes it, and that one decision changes how the harness is built, extended, and debugged. ## Docs > Install clai, drive an agent from the REPL or browser, configure models and providers, and read the reference for tools, hooks, and the HTTP API. - [Guides](https://charming-taffy-d953e6.netlify.app/docs/guides/): Step-by-step guides for installing clai, using the REPL and web UI, configuring models, and extending the harness with tools and plugins. - [Reference](https://charming-taffy-d953e6.netlify.app/docs/reference/): Precise reference pages for clai's configuration keys, built-in tools, HTTP and WebSocket API, event vocabulary, plugin hooks, and namespaces. ### Guides > Step-by-step guides for installing clai, using the REPL and web UI, configuring models, and extending the harness with tools and plugins. - [Getting Started](https://charming-taffy-d953e6.netlify.app/docs/guides/getting-started/): Install clai, start a local model or provider, open your first session from the REPL, and learn the safety rules before letting an agent run code. - [Using the REPL](https://charming-taffy-d953e6.netlify.app/docs/guides/using-the-repl/): Drive a clai session from a Clojure REPL with new!, prompt!, and resume!, and learn how session namespaces and shell helpers keep work addressable. - [The Web UI](https://charming-taffy-d953e6.netlify.app/docs/guides/the-web-ui/): Build and run the clai web UI, then use its session console, REPL panel, namespace explorer, agent configs, notes, plugins, and usage dashboard. - [Configuring Models and Providers](https://charming-taffy-d953e6.netlify.app/docs/guides/configuring-models-and-providers/): Resolve clai's configuration file, choose Ollama or OpenRouter models, tune chat options and compaction, and add per-project instructions with AGENTS.md. - [Tools and Sub-agents](https://charming-taffy-d953e6.netlify.app/docs/guides/tools-and-sub-agents/): See what clai's built-in tools do, how per-agent tool registries work, and how spawn_agent runs an isolated sub-agent with its own prompt and model. - [Writing Plugins](https://charming-taffy-d953e6.netlify.app/docs/guides/writing-plugins/): Package Clojure code as a clai plugin jar, hook into session namespaces and system prompts, and choose which plugins an agent configuration runs. - [Architecture](https://charming-taffy-d953e6.netlify.app/docs/guides/architecture/): How clai fits one JVM, the agent loop, PostgreSQL session log, provider protocol, plugin hooks, and authentication into a single-process harness. - [Development](https://charming-taffy-d953e6.netlify.app/docs/guides/development/): Run clai's test suite with malli instrumentation, build an uberjar or plugin jar, serve cljdoc locally, and develop the React UI against a live daemon. ### Reference > Precise reference pages for clai's configuration keys, built-in tools, HTTP and WebSocket API, event vocabulary, plugin hooks, and namespaces. - [Configuration](https://charming-taffy-d953e6.netlify.app/docs/reference/configuration/): Reference for clai's EDN configuration keys, model and provider resolution, PostgreSQL and OpenProject settings, and every supported environment variable. - [Tools](https://charming-taffy-d953e6.netlify.app/docs/reference/tools/): Reference for every built-in clai tool: file and shell access, Clojure evaluation, sub-agents, clojure-lsp navigation, notes, and OpenProject work packages. - [HTTP API](https://charming-taffy-d953e6.netlify.app/docs/reference/http-api/): Reference for the clai daemon's authentication, WebSocket protocol, session and configuration endpoints, file and namespace explorers, notes, and usage stats. - [Events](https://charming-taffy-d953e6.netlify.app/docs/reference/events/): Reference for clai's session event vocabulary: user prompts, agent messages and thoughts, tool calls, Clojure forms, and compaction summaries. - [Plugin Hooks](https://charming-taffy-d953e6.netlify.app/docs/reference/plugin-hooks/): Complete reference for clai plugin descriptors, hook priority and ordering, the context each hook receives, and the values a hook may return. - [Namespaces](https://charming-taffy-d953e6.netlify.app/docs/reference/namespaces/): A map of the clai source tree: the REPL client, agent loop, providers, tools, daemon, storage, plugins, events, and shell helpers.