Product overview

The FactionOS surface map.

Local command, visible agent work, optional team signals.

FactionOS connects hook events, a local server, the web cockpit, command-line workflows, and shared protocol contracts. War Room collaboration is optional and separate from the local baseline. Discord, Telegram, and generic HTTPS adapters are optional outbound paths. The zero-install demo is synthetic and separate from real local sessions.

Default local-first Account not required Website static

Product surfaces

Every surface has a job and a boundary.

The overview separates local runtime surfaces, optional collaboration, outbound notifications, and the synthetic public demo so visitors can understand what is installed, what is optional, and what remains static.

Cockpit

Web cockpit

Status local

A local browser surface for watching missions, agent lanes, lifecycle events, and review state without turning the public website into a hosted app.

Role
Operator view for active agent work.
  • Mission and lane visibility for parallel agent work.
  • Status rings and bounded timeline rows instead of raw terminal scrollback.
  • Review checkpoints that keep task intent visible.

Boundary The cockpit is product runtime UI, not this static page. Local state is read only when the local install is running.

See cockpit features

Ingest

Hook event pipeline

Status local

Development hooks turn prompt lifecycle markers, tool activity, file-touch signals, and validation outcomes into structured local events.

Role
Source of local workflow signals.
  • Lifecycle events become bounded records.
  • File and command signals stay attached to local context.
  • Failures can be shown as visible states rather than silent gaps.

Boundary Hook ingest starts on the developer machine and does not imply default upload of prompts, paths, credentials, or source files.

Follow the ingest flow

Control

CLI

Status local

Command-line workflows let operators run, inspect, and validate local FactionOS behavior from the same terminal context as the codebase.

Role
Developer entry point and local control plane.
  • Start and inspect local product surfaces.
  • Run validation gates close to the workspace.
  • Keep operator actions explicit instead of hidden automation.

Boundary CLI output shown here is authored sample copy. Real terminal output is not collected by the public website.

Review setup flow

Contract

Protocol

Status local

Shared event contracts keep hooks, server state, adapters, and UI surfaces aligned as product boundaries become more complex.

Role
Typed connective tissue between surfaces.
  • Consistent event names and payload shapes.
  • Clear separation between local snapshots and optional outbound notices.
  • Reduced drift between CLI, server, cockpit, and adapters.

Boundary Protocol descriptions do not expose repository content or user-provided code from a visitor browser.

Inspect the architecture

Collaboration

Optional War Room

Status optional

A collaboration surface can summarize team-visible mission state when deliberately enabled, with redaction and service boundaries treated as product requirements.

Role
Optional shared view for coordinated work.
  • Team-readable mission state when configured.
  • Redaction posture belongs next to collaboration claims.
  • Local-only operation remains the baseline product story.

Boundary War Room collaboration is optional and separate from the local baseline. It is not a default hosted account, public replay service, or blanket storage promise.

Review trust boundaries

Notifications

Outbound adapters

Status outbound

Discord, Telegram, and generic HTTPS adapters are optional outbound paths. They can send narrow notifications to external systems such as team chat or downstream automation after an operator opts in.

Role
Optional external notification path.
  • Payloads must be explicit and bounded.
  • External destinations remain separate from the public website.
  • Operators control whether a notification path exists.

Boundary Adapters stay outbound-only in this overview. They are not inbound command channels, visitor analytics, or automatic telemetry.

Compare adapter scope

Preview

Static demo

Status synthetic

The public demo is a separate synthetic preview for inspecting product feel without connecting to a visitor workspace or hosted runtime session.

Role
Zero-install product preview.
  • Product-like UI without local setup.
  • Deterministic sample data for public inspection.
  • Clear separation from real prompts, paths, and replay data.

Boundary The zero-install demo is synthetic and separate from real local sessions. It does not prove broad hosted media readiness or live customer telemetry.

Understand demo scope

Static proof panels

Product-like examples without live customer data.

These panels use authored sample states to show how each surface fits together. They do not query a local runtime, embed replay data, or present visitor telemetry.

Static cockpit sample

Cockpit mission board

Proof local sample

A mission board can show lanes, statuses, and review checkpoints when the local runtime is installed.

Lanes
3 sample Planner, builder, and review lanes.
State
bounded Status summaries instead of raw logs.

No live telemetry Rows are authored sample data; no browser, workspace, or hosted session is queried.

Local event sample

Hook ingest queue

Proof local sample

Hook events normalize local lifecycle signals before the cockpit reads state.

Input
hook event Local lifecycle marker.
Output
snapshot Bounded state for UI consumption.

No live telemetry Prompt bodies, paths, credentials, and user code are not shown in this static proof.

Terminal copy sample

CLI operator rail

Proof local sample

The CLI keeps local setup and validation commands close to the development workflow.

Mode
local Operator-run commands.
Visibility
explicit No hidden automation in page copy.

No live telemetry No real terminal transcript, token, or command output is collected by this page.

Typed shape sample

Protocol contract lane

Proof local sample

Shared contracts keep event names and payload expectations aligned across surfaces.

Shape
typed Named event and state fields.
Drift
reduced One contract vocabulary across surfaces.

No live telemetry Contract examples are descriptive and do not include visitor-provided code.

Optional shared surface

War Room collaboration

Proof optional

A team view can expose mission posture after redaction and service boundaries are configured.

Default
off Local baseline remains primary.
Posture
redacted Shared state must stay intentionally bounded.

No live telemetry Optional collaboration is not a default hosted account or public replay guarantee.

Adapter sample

Outbound notification path

Proof outbound

Adapters can publish narrow status messages to chosen destinations when an operator enables them.

Direction
outbound Explicit external notice.
Trigger
operator No automatic visitor telemetry.

No live telemetry Adapters are outbound notifications only here, not inbound control or analytics channels.

Separate preview

Synthetic public demo

Proof synthetic

The demo lets visitors inspect a product-like surface without connecting to live local state.

Data
synthetic Deterministic preview rows.
Runtime
separate External demo destination.

No live telemetry Demo data is synthetic and separate from real replay data or broad media release claims.

Operating model

Local-first by default, explicit when a signal leaves.

Local-first by default for the core workflow. Product surfaces can coordinate local events, cockpit state, and optional notifications without turning this website into a hosted control plane.

  1. 01

    Hook ingest captures a bounded event.

    A CLI or editor hook records a lifecycle marker such as prompt started, tool requested, file touched, or validation completed.

    Input
    Developer workflow signal
    Output
    Structured local event

    Boundary No prompt body, path list, credential, or source file is uploaded by default.

  2. 02

    The local server normalizes state.

    The local FactionOS server accepts the event, aligns it to the protocol contract, and prepares a bounded snapshot.

    Input
    Structured local event
    Output
    REST snapshot

    Boundary The server is product runtime behavior, not a call made by this static page.

  3. 03

    The cockpit refreshes operator visibility.

    A local browser cockpit can read snapshots and stream updates through WebSocket behavior when the runtime is installed.

    Input
    Bounded state change
    Output
    Mission and lane update

    Boundary This page does not open a WebSocket or embed a live replay.

  4. 04

    Optional outbound notifications stay explicit.

    If configured, an adapter can send a narrow status notice to an external destination under that adapter contract.

    Input
    Operator-approved state
    Output
    External notice if enabled

    Boundary Adapters are optional, outbound-only, and not automatic visitor analytics.

Protected by copy boundary

Default non-uploads

Prompts

Default no upload

Prompt bodies are not collected by this website or promised as hosted storage.

Local paths

Default local scope

Repository paths and file names remain local unless an operator chooses an explicit integration.

Terminal output

Default sample only

Public copy uses authored samples instead of real command transcripts.

Replay data

Default synthetic

Static demos and proof panels are synthetic, not public replay hosting.

Credentials

Default never asked

Secrets and tokens are not requested by this public page.

User code

Default not read

User-provided source code is outside the public website data surface.

Next step

Inspect the demo, then keep the docs open.

Synthetic zero-install demo hosted separately from this website. Use the public docs for setup context. The related pages split deeper details into features, workflow, and trust boundaries.

External demo separate site

Synthetic zero-install demo hosted separately from this website.

External docs separate site

Public GitBook documentation hosted separately from this website.

Boundary External demo and docs links leave this static website. Internal routes are static page destinations, not hosted account creation or telemetry paths.