Waiting on a choice Updated Nov 20

Familiar

A character that helps on your PC: bring your own model and a character card, and get chat, memory, reminders and tools. Later it lives in a Desktop Buddies buddy.

Right now

Tool server link built, next fixes planned

Cards and her personality are done. Familiar's own link to the tool servers you add is built, and two rounds of review fixes are in. The next round waits on a choice from Severian.

Steps 9 of 21

Back to now Open every stage

Activity Nov 13 to today, 18 updates

Today
  1. 01

    Plan

    3/3Done

    What it is, how it's built, and in what order, agreed first.

    Updated

    1. Plan

    Steps 3 of 3

    • done: Plan page
    • done: Severian's build order folded in
    • done: Severian's OK

    Done when Severian OKs the plan.

    Updates

    1. The plan now follows Severian's order: Familiar ships on its own first, and the buddy link comes later.

    2. First plan written: a character that helps on your PC, with your own model, memory, reminders and tools.

    Settled

    • PlanSeverian OK'd the plan and its order.
    • ShapeA small Windows app. You bring the model and the character card. No account, no telemetry.
    • OrderFamiliar on its own first. The buddy link after Desktop Buddies' next interface is out.
  2. 02

    Foundations

    3/3Done

    The app shell and the risky questions answered early.

    Updated

    2. Foundations

    Steps 3 of 3

    • done: Workspace, tests and a stand-in model
    • done: Three early checks
    • done: The app shell

    Done when The shell runs on Windows and the early checks have answers.

    Updates

    1. Familiar can now talk to models: OpenRouter, OpenAI, Anthropic, Gemini, Ollama, LM Studio or any compatible server, with a Test button that proves tool use, listed prices, and spending caps that reserve a reply's worst case so a cap is never passed.

    2. The Windows shell is built and every one of its 70 security checks passes on a Windows runner: keys typed in their own Settings window that no page can read back, data sent only where the person approved, and programs started only after Windows' own dialog asks.

    3. Familiar's Windows program now builds on GitHub's Windows machines, and its first security checks all pass, including that its pages can only send data through paths the person approved.

    7 older
    1. The design for Familiar's Windows program is settled, with the owner's choices on when it's finished and where keys are typed. Building it has started.

    2. All three early checks say yes. The last one showed that Familiar can start a tool server you've added on Windows without a console window popping up, hand it only the settings it needs, and stop everything it started the moment Familiar closes, even if it crashes.

    3. Two of the three early checks say yes. The library that talks to your chosen model, and the engine that lets a conversation pick up after a restart, both run inside the app's window with no extra pieces. The third check, starting a tool server on Windows, is running now.

    4. The groundwork is finished and checked automatically: every change now runs the tests on Linux and Windows, and they pass.

    5. Familiar now knows when to stay quiet. It follows the reaction rules Severian agreed: quiet under fullscreen or do-not-disturb, a greeting when you come back after a while, and at most one unprompted line every few minutes. A bare "thanks" or "ok" gets a small reaction instead of a reply, unless it answers her question.

    6. Building began. The project now has its workspace and tests, a stand-in model that answers from a script, and a stand-in tool server, so everything can be built and checked without a paid model or any keys.

    7. Severian OK'd the plan, and building has started.

  3. 03

    Models and turns

    2/2Done

    Talk to your own model, and pick up where it left off.

    Updated

    3. Models and turns

    Steps 2 of 2

    • done: Bring your own model
    • done: A turn loop that resumes

    Done when A conversation survives a restart mid-task.

    Updates

    1. Conversations now survive a crash. Every step of a reply is kept in a journal on the PC, so if Familiar is killed mid-reply it picks up where it was, never runs a tool twice, and still asks before any tool that writes or sends. Everything built so far is now in the main version.

  4. 04

    Cards and memory

    1/2Next

    A character card gives it a persona; it remembers across restarts.

    Updated

    4. Cards and memory

    Steps 1 of 2

    • done: Character cards and lorebooks
    • Memory

    Done when A card's persona holds and notes survive a restart.

    Updates

    1. Familiar's link to outside tool servers is being redesigned from first principles: saving one change at a time, and a tool runs only on your yes for that exact call. A second plan sets out which models decide when she reacts and which one talks.

    2. Her personality rules came back from a first test run with training data: they held, and one unclear sentence (a click can't make a clingy persona go quiet) is now stated outright. One question goes to the owner: should a click always get a small gesture?

    3. Familiar now reads character cards: V1, V2 and V3, from JSON or PNG, with their lorebooks, and builds her prompt from them within a budget. It also reads her temperament from the card: how sociable she is, how much she seeks you, and when she's at her liveliest, each with the card's own words as the reason, and anything you set yourself is never overwritten. No card, however strange, can make it hang or carry her text into a log.

  5. 05

    Tools

    0/3In progress

    Reminders, notes and the tool servers you add, each risky step asking first.

    • Pick how the next round of tool server fixes goesWaiting on Severian

    Updated

    5. Tools

    Steps 0 of 3

    • Built-in tools and reminders
    • Tool servers you add
    • What it can do, at a glance

    Done when A table in Settings shows what it can do and what's missing.

    Updates

    1. Familiar's own client for tool servers is built, for older and newer servers alike. Two rounds of review fixes followed, each fix with its own test. The next round is planned and waits on a choice from Severian.

    2. The new design for tool servers is settled and the rebuild is under way: Familiar's own client for tool servers, for older and newer servers alike, is being built and has started passing its Windows checks.

  6. 06

    Chat and setup

    0/3Next

    The chat window, first run and settings.

    6. Chat and setup

    Steps 0 of 3

    • Chat window
    • First-run setup
    • Settings

    Done when A new person can set it up unaided.

  7. 07

    Shipping

    0/3Later

    Installable from GitHub, and winget once it's public.

    7. Shipping

    Steps 0 of 3

    • Installer and release
    • Checks on a real PC
    • Reviews and fixes

    Done when It installs and runs on a real PC.

  8. 08

    In a buddy

    0/2Later

    The persona takes over one Desktop Buddies buddy as its body.

    8. In a buddy

    Steps 0 of 2

    • The buddy link
    • citadel's agents as buddies too

    Done when A buddy thinks, works and talks while Familiar does things.

By the numbers

Parts
2
Steps in part 1
14

Counted from the code, as of

Every update

18, newest first
  1. Familiar's own client for tool servers is built, for older and newer servers alike. Two rounds of review fixes followed, each fix with its own test. The next round is planned and waits on a choice from Severian.

    5 Tools
  2. The new design for tool servers is settled and the rebuild is under way: Familiar's own client for tool servers, for older and newer servers alike, is being built and has started passing its Windows checks.

    5 Tools
  3. Familiar's link to outside tool servers is being redesigned from first principles: saving one change at a time, and a tool runs only on your yes for that exact call. A second plan sets out which models decide when she reacts and which one talks.

    4 Cards and memory
  4. Her personality rules came back from a first test run with training data: they held, and one unclear sentence (a click can't make a clingy persona go quiet) is now stated outright. One question goes to the owner: should a click always get a small gesture?

    4 Cards and memory
  5. Familiar now reads character cards: V1, V2 and V3, from JSON or PNG, with their lorebooks, and builds her prompt from them within a budget. It also reads her temperament from the card: how sociable she is, how much she seeks you, and when she's at her liveliest, each with the card's own words as the reason, and anything you set yourself is never overwritten. No card, however strange, can make it hang or carry her text into a log.

    4 Cards and memory
  6. Conversations now survive a crash. Every step of a reply is kept in a journal on the PC, so if Familiar is killed mid-reply it picks up where it was, never runs a tool twice, and still asks before any tool that writes or sends. Everything built so far is now in the main version.

    3 Models and turns
  7. Familiar can now talk to models: OpenRouter, OpenAI, Anthropic, Gemini, Ollama, LM Studio or any compatible server, with a Test button that proves tool use, listed prices, and spending caps that reserve a reply's worst case so a cap is never passed.

    2 Foundations
  8. The Windows shell is built and every one of its 70 security checks passes on a Windows runner: keys typed in their own Settings window that no page can read back, data sent only where the person approved, and programs started only after Windows' own dialog asks.

    2 Foundations
  9. Familiar's Windows program now builds on GitHub's Windows machines, and its first security checks all pass, including that its pages can only send data through paths the person approved.

    2 Foundations
  10. The design for Familiar's Windows program is settled, with the owner's choices on when it's finished and where keys are typed. Building it has started.

    2 Foundations
  11. All three early checks say yes. The last one showed that Familiar can start a tool server you've added on Windows without a console window popping up, hand it only the settings it needs, and stop everything it started the moment Familiar closes, even if it crashes.

    2 Foundations
  12. Two of the three early checks say yes. The library that talks to your chosen model, and the engine that lets a conversation pick up after a restart, both run inside the app's window with no extra pieces. The third check, starting a tool server on Windows, is running now.

    2 Foundations
  13. The groundwork is finished and checked automatically: every change now runs the tests on Linux and Windows, and they pass.

    2 Foundations
  14. Familiar now knows when to stay quiet. It follows the reaction rules Severian agreed: quiet under fullscreen or do-not-disturb, a greeting when you come back after a while, and at most one unprompted line every few minutes. A bare "thanks" or "ok" gets a small reaction instead of a reply, unless it answers her question.

    2 Foundations
  15. Building began. The project now has its workspace and tests, a stand-in model that answers from a script, and a stand-in tool server, so everything can be built and checked without a paid model or any keys.

    2 Foundations
  16. Severian OK'd the plan, and building has started.

    2 Foundations
  17. The plan now follows Severian's order: Familiar ships on its own first, and the buddy link comes later.

    1 Plan
  18. First plan written: a character that helps on your PC, with your own model, memory, reminders and tools.

    1 Plan

Visits are counted with Google Analytics. Your choice ยท How Google uses this