Skip to content

feat: rename icontext → fbrain; deprecate icontext CLI/skills (v0.5.0) #4

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
federicodeponte merged 1 commit into from
May 5, 2026
Merged

feat: rename icontext → fbrain; deprecate icontext CLI/skills (v0.5.0) #4

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
53 changes: 32 additions & 21 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,15 +1,26 @@
# Changelog

All notable changes to iContext will be documented in this file.
All notable changes to fbrain will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).

## [0.5.0] - 2026-05-06

### Changed
- Renamed the Python package, primary CLI, documentation, MCP server branding, and user-facing scripts from fbrain's former `icontext` name to `fbrain`.
- `fbrain` is now the canonical command and package name.
- Renamed canonical skills to `fbrain-populate-profile`, `fbrain-refresh-profile`, `fbrain-share-card`, and `fbrain-write-fact`.

### Deprecated
- `icontext` remains available as a CLI shim for one release cycle. It prints a deprecation warning and forwards to `fbrain`; removal is planned for v0.6.0.
- `skills/icontext-*` remain as deprecated redirect stubs for one release cycle; removal is planned for v0.6.0.

## [0.4.0] - 2026-05-04

### Added
- **`icontext-write-fact` skill.** Explicit decision tree that routes content to the correct vault location before writing. Covers six categories: legal/entity facts (`vault/legal/`), project facts (`vault/projects/`), team/people (`vault/team/`), strategy (`vault/strategy/`), secretarial activity (`vault/secretary/logs/`), and credentials. Includes a full top-level vault directory reference so agents can match against the real structure without guessing. Eliminates the recurring "agent dumps legal facts in log files" failure mode.
- `icontext-populate-profile` now references `icontext-write-fact` for any durable facts surfaced during profile synthesis (e.g. company registrations, attorney contacts, funding dates).
- `icontext-write-fact` ships with `icontext init` — installed to `~/.claude/skills/` and `~/.cursor/rules/` alongside the existing three skills.
- **`fbrain-write-fact` skill.** Explicit decision tree that routes content to the correct vault location before writing. Covers six categories: legal/entity facts (`vault/legal/`), project facts (`vault/projects/`), team/people (`vault/team/`), strategy (`vault/strategy/`), secretarial activity (`vault/secretary/logs/`), and credentials. Includes a full top-level vault directory reference so agents can match against the real structure without guessing. Eliminates the recurring "agent dumps legal facts in log files" failure mode.
- `fbrain-populate-profile` now references `fbrain-write-fact` for any durable facts surfaced during profile synthesis (e.g. company registrations, attorney contacts, funding dates).
- `fbrain-write-fact` ships with `fbrain init` — installed to `~/.claude/skills/` and `~/.cursor/rules/` alongside the existing three skills.
- CLAUDE.md snippet updated to list all four skills.
- Tests for the new skill: frontmatter, decision tree category coverage, init installation, Cursor rule, skills-list count, and CLAUDE.md reference.

Expand All @@ -20,11 +31,11 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).

### Added
- **Multi-device sync.** Your vault now follows you across machines via a private git remote.
- `icontext push` — commit and push local changes to origin
- `icontext pull` — rebase against origin with autostash (last-writer-wins, surfaces conflicts)
- `icontext autosync start|stop|status` — background agent that runs `icontext push` every 60 seconds
- macOS: `launchd` at `~/Library/LaunchAgents/dev.icontext.autosync.plist`
- Linux: `systemd --user` timer at `~/.config/systemd/user/icontext-autosync.timer`
- `fbrain push` — commit and push local changes to origin
- `fbrain pull` — rebase against origin with autostash (last-writer-wins, surfaces conflicts)
- `fbrain autosync start|stop|status` — background agent that runs `fbrain push` every 60 seconds
- macOS: `launchd` at `~/Library/LaunchAgents/dev.fbrain.autosync.plist`
- Linux: `systemd --user` timer at `~/.config/systemd/user/fbrain-autosync.timer`
- `user-prompt-submit` hook now pulls from origin in the background if a remote is configured, so Claude Code sees fresh context from other machines at the start of every prompt.
- CLAUDE.md snippet references the multi-device sync workflow.
- Tests for `push`, `pull`, and `autosync` (--help, no-origin hint, status reports not running on clean home).
Expand All @@ -37,37 +48,37 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
### Fixed
- `cli.py` syntax error in `cmd_init` final message (escaped quote in f-string broke fresh installs)
- Doctor now recognizes skills-first install mode and downgrades legacy-mode checks to warns
- Doctor checks connector files at install root (`~/icontext/connectors/`), not inside vault
- Doctor checks connector files at install root (`~/fbrain/connectors/`), not inside vault
- Doctor `gitleaks` invocation uses `detect` subcommand (not the invalid `dir`)

### Added
- "How it works" technical depth section in README (synthesis pipeline, cross-tool support, privacy)
- CHANGELOG.md (Keep a Changelog format)

### Changed
- Skill `icontext-populate-profile`: tiered relationship threshold, project-vs-task distinction, explicit date instruction (raised dogfooded quality from 6.5/10 to 8/10)
- Skill `fbrain-populate-profile`: tiered relationship threshold, project-vs-task distinction, explicit date instruction (raised dogfooded quality from 6.5/10 to 8/10)

## [0.2.0] - 2026-05-02

### Added
- Skills-first architecture: `icontext init` installs three skills into `~/.claude/skills/` and `~/.cursor/rules/`
- `icontext-populate-profile`: agent-driven profile synthesis with cascade (Gmail MCP -> LinkedIn -> user-described)
- `icontext-refresh-profile`: staleness handling for keeping profiles current
- `icontext-share-card`: shareable summary card generation
- Skills-first architecture: `fbrain init` installs three skills into `~/.claude/skills/` and `~/.cursor/rules/`
- `fbrain-populate-profile`: agent-driven profile synthesis with cascade (Gmail MCP -> LinkedIn -> user-described)
- `fbrain-refresh-profile`: staleness handling for keeping profiles current
- `fbrain-share-card`: shareable summary card generation
- Modular profile output split across `user.md`, `relationships.md`, `projects.md`, `context-card.md`
- `icontext skills` subcommand (list, update)
- `icontext --version` flag
- `fbrain skills` subcommand (list, update)
- `fbrain --version` flag
- Comparisons section in README covering mem0, OpenMemory, Obsidian, Pieces, CLAUDE.md, and Cursor Rules
- Demo GIF in README
- Threat model documented in SECURITY.md
- 80 tests across connectors, CLI, and doctor
- Polished CLI output with color and structure
- Copy-pasteable Claude prompt printed after `icontext init`
- Copy-pasteable Claude prompt printed after `fbrain init`
- Demo script and README quickstart

### Changed
- `icontext init` no longer requires a Gemini API key
- `icontext sync` (Gemini-driven) is now an optional headless fallback (`pip install icontext[sync]`)
- `fbrain init` no longer requires a Gemini API key
- `fbrain sync` (Gemini-driven) is now an optional headless fallback (`pip install fbrain[sync]`)
- Synthesis pipeline rewritten as 3-stage architecture (extract -> validate -> render), used by optional sync
- README hero rewritten around "Your AI agents now share a brain"
- Replaced ai-sidecar dependency with Gemini SDK; credentials now stored via OS keychain
Expand All @@ -89,4 +100,4 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).

## [0.1.0] - 2026-04-26

Initial public release. Vault structure with sensitivity tier checks, MCP context index server, basic Gmail and LinkedIn connectors, icontext CLI, prompt hook for Codex/Cursor/OpenCode, and CI secret scanning via gitleaks.
Initial public release. Vault structure with sensitivity tier checks, MCP context index server, basic Gmail and LinkedIn connectors, fbrain CLI, prompt hook for Codex/Cursor/OpenCode, and CI secret scanning via gitleaks.
6 changes: 3 additions & 3 deletions CONTRIBUTING.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
# Contributing

Thanks for your interest in iContext.
Thanks for your interest in fbrain.

## Reporting issues

Expand All @@ -19,8 +19,8 @@ Thanks for your interest in iContext.
## Local development

```bash
git clone https://github.com/floomhq/icontext ~/icontext-dev
cd ~/icontext-dev
git clone https://github.com/floomhq/fbrain ~/fbrain-dev
cd ~/fbrain-dev
pip install -e .
pip install pytest
pytest tests/
Expand Down
Loading
Loading