The manual
01Start
What PremAgentic isWhat PremAgentic does, the claim it makes about the network and how that claim is tested, what setup needs once, and what it does not do.
Getting startedFrom a fresh clone to a cited answer, with the access gate proven, in the first ten minutes.
Connect an assistantHow an assistant connects over MCP with an agent token, and what it can reach.
02How it decides
AccessHow who may read a document is decided: ordered access lists and folder rules, agents and where their models run, and the second line of access control in the database.
Lifecycle, trust and freshnessThe lifecycle, trust and freshness gates, Open Knowledge Format frontmatter, undeclared authorship in a bundle, and the review queue.
AdministrationThe administration portal, the trust settings, the change record, the audit trail and how long it is kept, with screenshots.
03Operate
InstallingInstalling on a PostgreSQL you already run, the roles and files setup makes, HTTPS from the first start, and the bundled PostgreSQL on Windows.
Running itRunning the API as a Windows service or a systemd unit, and what to set behind a reverse proxy.
Upgrading and removingHow to upgrade and roll back, and how prem remove takes away the services with or without the data.
ConfigurationThe environment variables every host reads, their defaults, and what switching the embedding provider means.
StoragePlain PostgreSQL with no extension, the two schemas and their promises, migrations, the audit trail, and the vectors held in memory.
04Extend
Sources, readers and chunkersRegistering a folder as a source with its owner and hosted-model switch, the readers that read its files and the chunkers that cut them, and what a run did not read.
ExtensionsHow a reader, a chunker, an embedding provider or a way of signing in is added from a folder, allowed by hash, and refused with a reason.
Writing an extensionA walkthrough for writing an extension, proving it with the conformance kit, and allowing it in a deployment.
ConnectorsThe IDocumentSource extension point and the filesystem reference connector.
ProfilesA folder of plain files carrying a whole configuration, validated as a whole, applied as a whole, and compared with a deployment.
Tuning and the golden setThe retrieval settings that are per deployment, how to judge a change with the golden set, and why the golden set is the deliverable.
05Reference
SurfacesThe projects in the repository, the three ways a caller reaches the HTTP surface, agents over MCP, and your own words on the tools.
The prem commandEvery prem command with its arguments and options, as the program prints them.
Known stateWhat is built and tested, how the guards were checked, what the clean-install script proves, and what is not built.
RoadmapWhat comes next for PremAgentic.