Surfil

Ask your knowledge network with Pilot

Pilot answers questions from your signed Weave facts - architecture, conventions, billing model, auth - and cites the source doc and freshness for every answer. It is extractive-first and honest when it doesn't know, rather than confidently wrong.

Ask

Use the Ask screen or the CLI. Pilot draws only on facts already captured in Weave, so answers reflect your codebase, not the open internet.

$ surfil pilot ask "how does auth work here?"
→ Device flow (RFC 8628); tokens are Ed25519 in the keychain.
  source: acme/api@a91f · fresh (reviewed 3d ago)

Every answer cites its source

  • Source doc - which Weave fact the answer came from, with its commit or origin.
  • Freshness - when the fact was last reviewed. A fact whose code_hash no longer matches the code is auto-flagged stale.
  • Honest-empty - if no fact answers the question, Pilot says so instead of guessing. Secrets are never stored, so asking for one returns nothing.

Fill a gap

Missing an answer? Capture the fact on a linked device with surfil mind remember. It writes a signed fact to Weave with provenance, and the next question can use it.

Pilot reads Weave; it never reads your source directly. See Weave for how facts carry provenance and staleness.