ONTICFS(8) - System Manager's Manual

NAME

OnticFS - The epistemic filesystem. Mount a knowledge graph as POSIX.

SYNOPSIS

mount -t fuse.epistemic -o cartridge=sys:commerce-v1 /mnt/knowledge

DESCRIPTION

OnticFS is an open-source Rust FUSE filesystem where the mount IS the agent orchestration surface. It forces probabilistic AI into auditable, deterministic outputs at the OS boundary.

There is no chat interface. There is no REST API to learn. The filesystem is the API:

Knowledge graphs as directories: Navigate entities via ls and cd.
Typed edges as wiki-links: Write [[depends-on:uuid]] in a file to wire a graph edge.
Semantic recall as cat: Read from by-query/ to trigger vector search.

EXAMPLES

Interact with the graph using standard UNIX tools. The following examples assume a commerce cartridge is loaded.

# 1. Semantic search (triggers Qdrant projection)
cat "/mnt/knowledge/by-query/cheapest listing for product X"

# 2. Browse by primitive type
ls /mnt/knowledge/by-tag/listing/
ls /mnt/knowledge/by-tag/product/

# 3. Resolve a canonical label to a UUID
cat /mnt/knowledge/by-label/my-card-label

# 4. Walk the graph (traverse edges)
ls /mnt/knowledge/by-dep/<listing-uuid>/OFFERED_BY/

# 5. Ingest new knowledge (auto-indexed via inotify)
cp listing.json /mnt/knowledge/new/listing.json

# 6. Verify ingestion status
cat /mnt/knowledge/ingest-status/listing.json
status: VISIBLE

# 7. Audit unresolved cross-references
cat /mnt/knowledge/link-health/<uuid>
ghost: 0
unrecognized: 0

CARTRIDGES (BYOP)

OnticFS uses BYOP (Bring Your Own Physics) YAML cartridges to define the ontology. A cartridge specifies primitive subtypes, edge types, wiki-link markers, and automatic MIME routing.

When you write [[price-observed:snapshot-id]] in a file, the filesystem intercepts the write, validates it against the active cartridge, and wires the PRICE_OBSERVED edge in the underlying graph.

COMMUNITY TIER

NOTICE: We offer a free community tier hosted on our own bare metal. It is capacity-limited and comes with NO SLA. We are pre-revenue and running this for hackers, homelabbers, and OSS contributors. If you need SOC2 compliance or managed Google Cloud deployments, see the enterprise offering.

SOURCE CODE

The OnticFS kernel is open-source. Repository hosting is currently being finalized.

git clone https://git.onticfabric.io/onticfs.git # TODO: placeholder URL

CARTRIDGE REGISTRY ACCESS

Join the mailing list to get early access to the public cartridge registry (sys:commerce-v1, sys:work-graph-v1, etc.) and community tier provisioning.