Project Info
Inspiration
Attention is what everyone is fighting for right now. With the rise of For You Pages, every social platform is designed around an infinite feed. There is always another post, another notification, and another reason to keep scrolling. Access to information has improved, but consuming that information has become exhausting. I want to give control back to the user: the ability to decide which topics deserve their attention, which information they want to see more of, and when they have consumed enough. This is implemented by using cross-source semantic, to collapse similar content from difference author or source. And also a simple implementation if the content is AI generated or not. Lessen the burden of people who want to see AI generated content less. And as the Internet is changing constantly, browser it still the gateway to all the knowledge that available for human kind online. As we interact more and more with agent with MCP in the future a new kind of browser will be needed. Where the control is in the hand of the user not the server.
What it does
Instead of passively accepting everything pushed into a timeline, AkuBrowser helps users filter and prioritize what is relevant to them. Its goal is not to replace the platforms or discard everything their recommendation systems have learned. AkuBrowser works with the user’s existing authenticated Chrome session. It treats the existing feed order as a borrowed behavioral prior, then builds a user-owned preference and reasoning layer on top of it. The desired experience is simple: Show me what matters to me, explain why it matters, preserve the sources, and let me feel finished. It currently supports X, Facebook and LinkedIn. A typical session: Captures a bounded set of posts from the user’s authenticated X, Facebook, and LinkedIn feeds. Validates each observation while preserving its metadata and original context. Skips unchanged posts or that has already been delivered. Uses Codex for Acquisition Planning. To determines whether the available evidence is sufficient or whether one additional bounded observation would be useful, Uses Codex for Candidate Evaluation. To describes each candidate’s topics, materiality, novelty, urgency, actionability, and evidence strength. Combines those assessments with the user’s explicit interests and locally learned preferences. Filters candidates according to the user’s attention policy. Uses Codex for cross-source semantic reasoning to recognize posts about the same event, collapse repeated reports, and preserve meaningful updates or different perspectives. Composes the selected events into one finite, personalized timeline. Applies fast AI detection and Deep AI detection (using Codex) to filter AI post to a dedicated drawer (configurable) Ends with a clear “End of catch-up” marker. AkuBrowser currently learns through explicit interaction rather than passive surveillance. Preference-based filtering and ranking are applied through deterministic application policy. The user remains the authority.
How we built it
AkuBrowser is divided into these independent components: AkuBridge is a read-only Chrome extension. It performs bounded, read-only capture, source-specific quality checks and sends structured evidence to AkuSidecar. AkuSidecar is a local Golang application. It owns the UI, storage persistence (SQLite), session orchestration, deterministic selection, preference policy and managed Codex App Server process (Acquisition Planning, Candidate Evaluation, Semantic Event Resolution, Deep AI Detection). AkuSidecar is a local Golang application. It owns the UI, storage persistence (SQLite), session orchestration, deterministic selection, preference policy and managed Codex App Server process (Acquisition Planning, Candidate Evaluation, Semantic Event Resolution, Deep AI Detection). AkuBrowser is the main product and integration repository. It owns the architecture, canonical contracts, compatibility checks, Windows and macOS packaging, and aggregate development workflows across the components. AkuBrowser is the main product and integration repository. It owns the architecture, canonical contracts, compatibility checks, Windows and macOS packaging, and aggregate development workflows across the components. AkuSupervisor is an optional tool based Rust-based local lifecycle supervisor. It perfect to work with agentic workflow. It has MCP protocol that can determine the right time to start, stop and restart the plugins or the sidecar. The usage of token and computer usage can be reduced greatly with using AkuSupervisor in repeated development cycle. AkuSupervisor is an optional tool based Rust-based local lifecycle supervisor. It perfect to work with agentic workflow. It has MCP protocol that can determine the right time to start, stop and restart the plugins or the sidecar. The usage of token and computer usage can be reduced greatly with using AkuSupervisor in repeated development cycle. AkuSupervisor may eventually be bundled with AkuBrowser as the local lifecycle engine responsible for launching and maintaining AkuSidecar. What we built during OpenAI Build Week AkuBrowser started with the release of GPT 5.6. Only with the release of Sol that I started to believe it possible to implement this Idea without taking a huge amount of time. At least until the MVP stage. OpenAI Build Week gives the opportunity to push the development further. During the Build Week submission period, we materially extended it with the help of Codex across all repositories. The Build Week work includes: Implementing AkuSidecar and rewrite it from Node.js (because codex sdk only available to Node.js) to Go (transition to Codex App Server) while preserving SQLite state, recovery, and product behavior Integrating Codex App Server for Acquisition Planning, Candidate Evaluation, cross-source semantic resolution, and AI Deep Detection, profiles and usage telemetry Implementing preference-aware selection with calibration, More/Less feedback, local learning, candidate filtering, and correction controls Building a cross-source Semantic Event Engine that collapses repeated reports while preserving meaningful updates, contradictions, and perspectives Expanding bounded, source-faithful capture to X, LinkedIn, and Facebook with shared quality, freshness, media, and lifecycle controls Adding AI Fast and Deep Detection with user-controlled Inline, Drawer, and confirmed Hide modes; Strengthening onboarding, session recovery, exact-evidence suppression, resurfacing, reset, and Sidecar-restart behavior Packaging verifiable Windows x64 and macOS universal portable previews with native AkuSidecar executables, platform launchers, provenance, checksums, and the bundled AkuBridge extension Extending AkuSupervisor with lifecycle ownership, cooperative Bridge reload, health and log monitoring, read-only MCP support, and synchronized cross-repository tests. And many others. It's fully build using Codex and GPT 5.6 The dated Git history and BUILD_WEEK.md document which capabilities existed before the event and which were added or materially extended during the competition.
Challenges we ran into
One of the hardest challenges was preserving source fidelity. Modern social sites are dynamic, and Chrome extension service workers can stop and restart. We built source-specific adapters, bounded retries, durable checkpoints, idempotent commands, and recovery paths so a partial capture or Sidecar restart does not corrupt the session. Preserving source fidelity was especially important to preserve the same consuming content feeling for the user. Preference filtering introduced another important challenge: information can be objectively material without being personally relevant. We needed to separate content understanding from user preference. Codex describes the content, while the user’s explicit interests and feedback determine how that content competes for their limited attention. And then implementation the cross-source semantic reasoning and AI filter to reduce the user burden to not ingest the same content or unwanted content. Security was equally important. Web content is untrusted evidence and may contain instructions intended to manipulate an AI agent. We isolates captured content from system instructions, limits the authority of the Reasoning Provider, validates every structured response, and keeps browser movement and filtering authority under deterministic policy. We also had to manage Codex token usage carefully. Development and runtime reasoning compete for the same limited resources. Finally, packaging a local system that spans Chrome, Go, SQLite, Codex, and a Rust supervisor is a product challenge of its own. We now provide clear portable entry points for Windows and macOS, while AkuSupervisor remains separate development tooling. A guided, signed installation and update experience remains future work.
Accomplishments we're proud of
We are most proud that our original idea—giving control of attention back to the user—became an enforceable product rather than only a design promise. AkuBrowser combines bounded capture from authenticated X, Facebook, and LinkedIn feeds with structured Codex reasoning, user-owned preference filtering, cross-source semantic event resolution, knowledge continuity, AI Signals, and one finite Timeline. We also proud for being able to deliver a working prototype of a very ambitious and vague idea in couple of weeks. Tackling the technical issue, even re-writing AkuSidecar to a different Languange and protocol it become a doable task for better architecture. Things that previously could become a huge blocker now just a matter how many tokens can be spend. And thus a good token management become an important part in the development of this project.
What we learned
We learned that AI works best when probabilistic reasoning is surrounded by deterministic boundaries. Codex can understand meaning, context, and evidence, but permissions, state and others must remain under application control. And development using AI doesn't mean you should let AI take the lead. It can lead you astray and spend token in places that is unnecessary and put you on difficult position when things need to be changed. A good token management is the key to deliver your project. We also learned that there's almost no boundary between the Idea you have and the possibility to implement it. Things that are difficult or take a very long time to implement could be done today. As long as you slice the specification correctly. It's worth to create a PoC to see is your idea actually make sense & feasible or not.
What's next
AkuBrowser currently supports Windows x64 and macOS through a universal portable bundle for both Intel and Apple silicon, covering X, Facebook, and LinkedIn. Each package includes AkuBridge and a native AkuSidecar, while AkuSupervisor remains separate development tooling. Our next direction is to simplify installation and updates, expand to more social media and web sources, and eventually support Linux. The long-term goal is to rethink how people consume information in the age of Intelligence. Where information is abundant and attention is fought over. Website is not the only way to access information. With the rise of Agent and MCP protocol, how agent can be discovered and access, will be the new frontier. And browser seems to still be in the forefront as our access gate. Managing all the information provided by servers or agents on the internet will be the next challenge for Aku Browser. We might not be dependent on static representation from the server. But could dynamically build dependent on the user needs and like. There's also the economics side of monetary transaction and serving ads. It will be all handled by agent in the browser. But some human will also feel the needs to have a channel that preserve only for human interaction without an agent involvement. This is the challenge for future browser. And AkuBrowser could be the first generation of that future browser.
AkuBrowser
Current release target: v0.9.0-rc.8 for Windows x64. Its planned distribution is one
unsigned installer .exe containing AkuBrowserLauncher,
AkuSidecar, the internal AkuBridge payload, pinned Chromium, c2patool, and the
release configuration/checksums needed by the isolated app shell. The release
must publish a SHA-256 checksum and explicitly disclose the unsigned SmartScreen
trust state. Independent clean-machine acceptance is still pending. The canonical
bundle boundary and gates are in the installed-app distribution
contract.
v0.9.0 RC8 distribution boundary. The target release path is one Windows x64 installed-app installer. It does not require the Chrome Web Store, system Chrome, Developer Mode, a manually loaded extension, or a separate runtime installer. The current candidate still carries an honest unsigned/SmartScreen warning; users should verify the checksum of any published installer. macOS and Linux are deferred and are not part of this release.
Chrome Web Store publication is frozen
The existing Chrome Web Store listing remains available to current users, but no new Store builds are published. New production work targets the single installed-app tuple, with AkuSidecar owning first-run onboarding in the isolated app shell. The listing and portable ZIP are historical/recovery lanes, not v0.9.0 RC8 release outputs. See the installed-app distribution target.
Release downloads
The next AkuBrowser v0.9.0-rc.8 release
will expose one Windows x64 installer .exe and its SHA-256 checksum as the
supported download. It is intentionally unsigned, so Windows may show a
SmartScreen warning. Verify the checksum and do not run it alongside the frozen
Store edition.
The old Windows/macOS runtime installers and portable bundles remain versioned historical/recovery assets. macOS and Linux downloads are explicitly deferred from v0.9.0 RC8.
AkuBrowser turns bounded samples from the user's chosen social feeds into one finite, source-backed Timeline. The current source registry supports four adapters: X, LinkedIn, Facebook, and opt-in Instagram. It is designed for people who want to keep up without surrendering their attention to another infinite feed.
Its cross-author semantic Event Engine treats the underlying event—not the number of posts about it—as the unit of attention. When different authors or sources report the same specific occurrence, AkuBrowser can collapse the repetition while preserving the reports for inspection and correction. The user reads the change once instead of paying the same attention cost again for every account that repeated it.
Its AI Signals layer adds a separate, explicitly uncertain view of AI origin. A local deterministic pass can annotate retained text immediately, while an asynchronous Codex pass may confirm, dispute, or correct that preliminary assessment. These signals never affect relevance selection or ranking. Drawer is the preview default; users may instead keep strong signals inline or, after an exact typed warning, hide only direct or Deep-confirmed results. Direct user correction has the highest presentation authority.
X media can also finish passively after the usable Timeline is already on screen. AkuBridge v60 keeps only short-lived, allowlisted post-media evidence from the rendered page or X's already-requested timeline/detail responses and may attach it to the matching retained item without making a provider request or opening or focusing a tab. Raw responses and post text never leave the page world or persist. Explicit quiet/foreground Recapture remains the fallback when that evidence never appears.
The personalization rule is equally direct: explicit user feedback has more authority than opaque engagement inferred by a social network. Once the local profile has enough repeated evidence, More and Not interested may promote, replace, demote, or suppress ordinary candidates. Evidence quality, material updates, contradictions, and one bounded discovery lane remain protected.
Distribution and workspace boundary
AkuBrowser is the distribution authority as well as the product-contract and integration repository. It owns release manifests, installed-app installer assembly, checksums, launchers, and acceptance guidance, while keeping application runtime code in its component repositories. AkuBrowser has no Node package or application runtime of its own.
Historical shipped distribution (pre-v0.9.0)
The staged consumer distribution path publishes the extension under the public
name AkuBrowser while retaining AkuBridge as the internal component name.
Its Native Messaging, companion installer, Store, and signed runtime-update
gates are preserved as current implementation history in
docs/chrome-store-distribution-contract.md.
Development and production extension IDs are named profiles in one registry;
their generated runtime projections are defined in
docs/bridge-identity-contract.md.
The pre-v0.9.0 end-user deployment had exactly two independently updated products: AkuBridge from the Chrome Web Store and AkuSidecar from the signed platform feed. The Native Messaging host is an internal helper shipped inside the AkuSidecar installer, not a third deployable. AkuSupervisor remains optional development tooling and is never required or shipped to Store users.
| Repository | Responsibility | Runtime |
|---|---|---|
AkuBrowser | Product contract, canonical schemas, distribution assembly, integration and artifact checks | PowerShell + POSIX shell release tooling |
AkuBridge | Read-only bounded Chrome capture | Browser JavaScript / Node test tooling |
AkuSidecar | UI, sessions, SQLite, reasoning, selection, personalization | Go |
AkuSupervisor | Optional development-only process ownership; excluded from end-user deployment | Rust |
Only AkuBridge uses npm, because it is the Chrome extension. AkuSidecar is fully Go. In development AkuSupervisor may start Sidecar; production installation and update do not depend on Supervisor.
Development and v0.9.0 RC8 release build
Run the workspace check from this repository:
.\scripts\check.ps1
That command first runs a fail-fast integration identity check across the release manifest and the public Bridge/Sidecar declarations, then verifies schemas, runs Go tests in AkuSidecar, and runs npm checks inside AkuBridge. The identity check is development/release tooling only: AkuBridge and AkuSidecar do not import one another or read sibling repositories at runtime. It does not read AkuSupervisor configuration or require AkuSupervisor to be present. AkuBrowser itself does not install npm dependencies.
For normal local operation, build AkuSidecar and let AkuSupervisor own its lifecycle:
cd ..\AkuSidecar
.\scripts\restart-dev.ps1
Open http://127.0.0.1:11122 (or http://localhost:11122). Load
..\AkuBridge as an unpacked Chrome extension once; subsequent extension
reloads use the Sidecar's cooperative reload_self contract. AkuSupervisor
remains only the generic process owner.
The v0.9.0 RC8 installed app uses the bundled pinned Chromium profile and does not require system Chrome or manual extension loading. Codex App with App Server remains an external prerequisite and must be installed and signed in locally. An optional Gemini provider accepts a user-supplied key through the Sidecar credential flow; provider hot-swaps apply at an idle boundary. The four source adapters are X, LinkedIn, Facebook, and opt-in Instagram. AkuSidecar uses the schema declared in the current release manifest and owns first-run onboarding, source readiness, and Timeline state. See Preview/release candidate notes.
The portable ZIP and Chrome Web Store package are historical/recovery lanes and are not v0.9.0 RC8 distribution paths.
Build and validate the Windows installed-app release from this repository:
.\scripts\build-windows-installed-app.ps1 -OutputRoot .\artifacts
.\scripts\test-windows-installed-app-builder.ps1 `
-ArtifactDirectory .\artifacts\AkuBrowser-<version>-windows-x64-installed-app
.\scripts\build-windows-installed-app-installer.ps1 `
-TupleDirectory .\artifacts\AkuBrowser-<version>-windows-x64-installed-app `
-NsisPath "C:\Program Files (x86)\NSIS\makensis.exe"
.\scripts\test-windows-installed-app-installer.ps1 `
-TupleDirectory .\artifacts\AkuBrowser-<version>-windows-x64-installed-app `
-InstallerPath .\artifacts\installed-app-installer\AkuBrowserSetup-0.9.0-windows-x64.exe
These commands produce the intentionally unsigned release artifact and matching checksum. Automated checks validate the tuple, hashes, launcher, and PE structure; the broader clean-machine matrix remains documented in the stable release checklist.
Historical portable preview build
The following commands reproduce the pre-v0.9.0 portable recovery lane; they are not the active single-installer release gate:
.\scripts\build-windows-preview.ps1
.\scripts\test-windows-preview.ps1
The generated directory, ZIP, and ZIP checksum are written beneath
artifacts\. Use -AllowDirty only while developing the pipeline; a publishable
artifact requires clean AkuBrowser, AkuSidecar, and AkuBridge source trees.
The old scripts/run-windows-stable-gate.ps1 flow produces the historical
Store/portable release kit. It is not the active v0.9.0 one-installer gate; keep
its outputs only for recovery and historical reproduction.
For a local release checkpoint, use the reconciled workflow instead:
.\scripts\prepare-local-release.ps1
It builds and smoke-tests the bundle, waits for Sidecar update readiness,
atomically rebuilds the Supervisor-owned development executable, verifies the
new health version, and reloads AkuBridge only when its capability heartbeat is
not already compatible. runtime\dev\aku-sidecar.exe.runtime-state.json records
the exact development source commit and binary hash. The workflow never tags,
pushes, or uploads a release. Use -SkipDevelopmentSync only when intentionally
building an isolated artifact without changing the active development runtime.
OpenAI Build Week
AkuBrowser began as an early bounded X/LinkedIn prototype and was materially extended during OpenAI Build Week. Working with Codex, the project rewrote AkuSidecar from Node.js to Go, moved runtime reasoning to Codex App Server, activated preference filtering, added cross-source semantic event resolution and AI Signals, expanded capture to Facebook, strengthened recovery, and built verifiable portable previews for Windows x64 and macOS on Intel and Apple silicon.
Codex accelerated architecture, implementation, live debugging, tests, documentation, and release preparation. In the running product, GPT-5.6 powers schema-bound Acquisition Planning, Candidate Evaluation, Semantic Event Resolution, and AI Deep Detection. AkuSidecar—not the model—remains responsible for permissions, budgets, validation, preference authority, SQLite state, and final composition.
The submission evidence, the distinction between earlier work and dated
submission-period extensions, and the release/judge workflow are in
BUILD_WEEK.md. The copy-ready project story is in
docs/openai-build-week-submission.md.
macOS and Linux packaging are deferred from v0.9.0. Their historical preview instructions remain below for reproducibility, but they are not release gates for this Windows-only candidate.
On macOS, the historical preview boundary was packaged with the native Go
Sidecar and the unpacked AkuBridge extension. Go, Node.js, npm, and the macOS
zip tools were needed on the build machine; end users needed Codex App/App
Server and Chrome. Build and smoke-test the historical host architecture with:
./scripts/build-macos-preview.sh
./scripts/test-macos-preview.sh
The default target matches the build Mac. Use --architecture x64 or
--architecture arm64 for a native single-architecture artifact, or
--architecture universal for a dual-architecture form. Use
--allow-dirty only for local pipeline development; a publishable artifact
requires clean AkuBrowser, AkuSidecar, and AkuBridge source trees. The artifact
directory, ZIP, and ZIP checksum are written beneath artifacts/. Installation
and launcher details are in
release/macos/README.md.
Build the historical Chrome Web Store macOS companion separately with
scripts/build-macos-runtime-installer.sh; validate its payload with
scripts/test-macos-runtime-installer.sh. The stable v0.7.9 release uses an
explicitly disclosed unsigned package, a pinned universal C2PA tool, and an
Installer warning page. Users must verify the adjacent SHA-256
and use macOS Privacy & Security > Open Anyway if Gatekeeper blocks the
package; they must never disable Gatekeeper globally. Developer ID Application
and Installer identities and notarization remain future hardening work. Stable
runtime-update manifests use the Mac signing-request producer and Windows
finalizer documented in docs/github-macos-signing-handoff.md; the private key
never leaves Windows.
Canonical documentation
- Installed-app distribution target
- v0.9.0 Windows release notes
- AkuBrowserLauncher Windows vertical slice
- Product contract
- Runtime contract
- LLM invocation and token cost reference
- AI Feedback Engine contract
- Personal Memory and Library contract
- Personal Memory product roadmap
- Living Topics Thin Slice contract
- Living Topics Full Stage 1 contract
- Preview release
- Stable release checklist
- Windows clean-machine Step 3B
- Windows preview acceptance
- macOS preview acceptance
- Build Week evidence and judge checklist
- OpenAI Build Week final project story
- Bridge Contract v2
- Active machine-readable schemas
Historical experiments and superseded contracts live in Git history, not in the active documentation set.
Analysis
View
Metric
- 105
Figures cover GitHub contributors during the hackathon window. A co-authored commit counts in full for each author, so per-member totals add up to more than the whole-team figures.
Technology
- GoIn code
- HTMLIn code
- JavaScriptClaimed
- Node.jsClaimed
- RustClaimed
2 of 5 appear in the indexed code. 3 claimed on Devpost could not be matched to code, which may simply mean the tool leaves no trace in the repository.
AI coding agents
No AI coding agent signals were found in this repository.
Detected from committed agent config files and commit authorship. Absence of a signal is not proof an agent was unused.
Codebase size
Source size
548 KB
Source files
67
Counts recognized source files only; vendored directories, binaries and lockfiles are excluded, so this is smaller than the repository on disk.
Repository
abangkis/AkuBrowser
134 files · 6.0 MB · @ be008e2
Structure
Interface
4 files · 3%Screens, components and styles rendered to the user.
Application logic
39 files · 29%Domain rules, services and shared utilities.
+5 more
Supporting
Layers are inferred from where files sit in the tree, not from reading the code. A project that names its directories unconventionally will read oddly here — open the file browser to check anything the diagram implies.
Languages
- Markdown61%
- Shell22%
- Go13%
- YAML3%
- HTML1%
- XML0%
Share of indexed source by file size. Binary and vendored files are excluded.
Dependencies
installer/windows/go.mod
go · 1- golang.org/x/sys
Declared in the repository’s manifests at the indexed commit. A declared package is not proof it is used, and runtime dependencies are listed first.
This project’s features have not been analysed yet.
Export this project's context (description, README, evidence, key source files) to chat with an AI agent elsewhere.