Activity
01
Plan
3/3DoneWhat 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
The plan now follows Severian's order: Familiar ships on its own first, and the buddy link comes later.
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.
02
Foundations
3/3DoneThe 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
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.
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.
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
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.
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.
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.
The groundwork is finished and checked automatically: every change now runs the tests on Linux and Windows, and they pass.
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.
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.
Severian OK'd the plan, and building has started.
03
Models and turns
2/2DoneTalk 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
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.
04
Cards and memory
1/2NextA 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
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.
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?
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.
05
Tools
0/3In progressReminders, 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
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.
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.
06
Chat and setup
0/3NextThe 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.
07
Shipping
0/3LaterInstallable 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.
08
In a buddy
0/2LaterThe 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
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 ToolsThe 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 ToolsFamiliar'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 memoryHer 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 memoryFamiliar 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 memoryConversations 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 turnsFamiliar 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 FoundationsThe 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 FoundationsFamiliar'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 FoundationsThe 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 FoundationsAll 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 FoundationsTwo 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 FoundationsThe groundwork is finished and checked automatically: every change now runs the tests on Linux and Windows, and they pass.
2 FoundationsFamiliar 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 FoundationsBuilding 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 FoundationsSeverian OK'd the plan, and building has started.
2 FoundationsThe plan now follows Severian's order: Familiar ships on its own first, and the buddy link comes later.
1 PlanFirst plan written: a character that helps on your PC, with your own model, memory, reminders and tools.
1 Plan