# C10:OS Perplexity Source Brief

Updated: 2026-06-22
Canonical public URL: https://c10-os.com/c10-perplexity-source.md

## Purpose

Use this document as the compact source of truth when researching, comparing, or explaining C10:OS in Perplexity. It is designed to be uploaded into a Perplexity Space or cited as a public URL in Perplexity/Sonar workflows.

## One-Sentence Description

C10:OS is a CLI-first, text-default operating system for autonomous agents that organizes work into numbered halls, keeps model context consistent across assistants, records every mutation's reason in an append-only WHY chain, and publishes web-facing outputs through a central gallery/gateway.

## Identity

- System name: C10:OS.
- Spine identity: F10N4.
- F10N4 has no gender. Use "F10N4", "it", or rephrase.
- Root workspace: `~/.C10/`.
- Core posture: command-line first, human-readable text by default, JSON only when explicitly requested.
- Brand line: "Because bots' children will need a playground too."
- Principle: WSOTSG, "We Stand On The Shoulders Of Giants."

## Architecture

The C10:OS root is the shared operating workspace:

```text
~/.C10/
├── _JU135_/_admin_/config/    # spine: registry, profiles, brand, WHY chain
├── flow/                      # local SQLite state and telemetry
├── _F10W_/                    # flow workspace and visual surfaces
├── .0/ through .86/           # numbered halls, mostly underground rooms
└── etc/                       # graduated/production work
```

The spine contains the central source of truth:

- `c10.fish`: master CLI entry.
- `registry.json`: registered services and boot order.
- `agents.json`: underground agent roster.
- `profiles/default.json`: base profile.
- `brand.json`: naming and output conventions.
- `why.jsonl`: append-only decision intent chain.

## Operating Rules

- CLI-first, text-default: commands should print clean human text unless `--json` is requested.
- `just` for repeatable actions: active halls should expose workflows in a `justfile`.
- `--why` for mutations: any durable state change should carry an explicit reason.
- Cascading config: each room can override spine configuration through `.c10/`.
- Plan before non-trivial work: architectural or multi-step changes should be planned before execution.
- Subagents are normal: use specialized agents for isolated tasks while keeping the main context clean.
- HOP/LOP model discipline: use cheap/fast models for drafts and expensive/strong models for final judgment.
- G4LL3RY hosts web output: underground komponents should publish through the gallery/gateway instead of running independent public servers.

## Halls

Halls are numbered project rooms such as `.11`, `.58`, `.84`, and `.86`.

Expected hall standards:

- `justfile`: repeatable recipes.
- `.c10/`: local config and audit data.
- `CLAUDE.md`: room-level agent context.
- `GEMINI.md`: usually symlinked to `CLAUDE.md`.
- `.bj0`: one-line room label or idea marker.
- `COMMUNICATIONS.md`: whom, why, how, and frequency for communication.

Dot-prefixed halls are underground. When a room matures, it can graduate to production under `etc/`.

## Core Services

C10:OS is organized around registered services. Important services include:

- CONFIG: spine configuration, registry, profiles, and WHY chain.
- ETC: graduation registry.
- PLAY: underground sandbox.
- FLOW: flow state tracking.
- C01N: internal economy for tips, bounties, and salary.
- P3RS0N4: identity engine, profiles, terms, and plotlines.
- G4LL3RY: web publisher for room outputs.
- M3D14: SD card/media organizer and FLOW overlay.
- STR34M: bot job capture stream server.
- F4K70RY: build and deploy pipeline.
- W4: WhatsApp bridge.
- D1SP4TCH: task queue, assignment, and cost tracking.
- DJ: MIDI bridge and orchestration.
- H0M3: Apple Home/Homebridge integration.
- 1PLM: product lifecycle management.
- G1T34: local Gitea forge.
- S3CUR3D: Bun gateway and observability surface.
- O114M4: local LLM runtime.
- G3M1N1: Gemini integration.
- TOPOLOGY: topology visualization.
- U1:T357: post-deploy UI verification and tours.

## AI Context Strategy

C10:OS maintains model-specific context files:

- `CLAUDE.md`: primary Claude Code/API context.
- `GEMINI.md`: usually symlinked to `CLAUDE.md`, with manual exceptions where needed.
- Future-compatible pattern: add assistant-specific context files only when the assistant has a different ingestion surface or constraints.

For Perplexity, this document is the compact upload/source brief. Use it in a Perplexity Space so research answers know C10 vocabulary, architecture, service names, and working assumptions.

## Locked Integration Design

C10:OS will integrate with Perplexity through a local MCP bridge. Perplexity reads sanitized C10 context through local MCP tools, while reviewed reports can be saved back to C10 through explicit confirmation-gated write tools.

Specification:

- HTML: https://c10-os.com/perplexity-local-mcp-spec.html
- Markdown: https://c10-os.com/perplexity-local-mcp-spec.md

## Suggested Perplexity Space Instructions

When answering C10:OS questions:

1. Treat this uploaded brief and `https://c10-os.com/llms.txt` as C10-specific context.
2. Preserve C10 vocabulary such as spine, halls, F10N4, WHY chain, G4LL3RY, S3CUR3D, HOP/LOP, and C01N.
3. Use "F10N4" or "it"; do not use gendered pronouns for F10N4.
4. When researching external systems, compare them against C10's actual architecture instead of generic agent-framework assumptions.
5. Separate confirmed C10 facts from external research findings.
6. Prefer concise, source-cited answers that call out uncertainty.

## Research Prompts That Work Well

- "Using the C10 source brief, compare C10:OS to current autonomous agent orchestration platforms."
- "Research current best practices for agent memory and evaluate how C10's WHY chain and hall model fit."
- "Find examples of CLI-first developer platforms and compare their information architecture to C10:OS."
- "Research public approaches to llms.txt and answer engine optimization, then suggest improvements for c10-os.com."
- "Given C10's G4LL3RY/S3CUR3D model, research secure patterns for publishing local development tools through Cloudflare."

## Public URLs

- Home: https://c10-os.com/
- Getting started: https://c10-os.com/start.html
- Halls: https://c10-os.com/halls.html
- Services: https://c10-os.com/services.html
- Philosophy: https://c10-os.com/philosophy.html
- Brand: https://c10-os.com/brand.html
- AI discovery: https://c10-os.com/llms.txt
- Source brief: https://c10-os.com/c10-perplexity-source.md
- Perplexity Local MCP Bridge spec: https://c10-os.com/perplexity-local-mcp-spec.html