flecha-browser
Open-source Arc alternative for macOS: a Chromium browser for developers with Spaces, a dev command bar and a built-in MCP server for coding agents.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 11 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/lucianodiisouza/flecha-browser with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/lucianodiisouza/flecha-browser'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/lucianodiisouza--flecha-browser)HTML
<a href="/listings/lucianodiisouza--flecha-browser"><img src="/api/listings/lucianodiisouza--flecha-browser/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
1. Download the latest `Flecha-<version>.dmg` from [Releases](https://github.com/lucianodiisouza/flecha-browser/releases). Releases are signed with a Developer ID and notarized by Apple. They are **Apple Silicon (arm64) only** for now; Intel is planned. 2. Open the dmg and drag Flecha onto Applications.
3. Optional, but needed for importing from other browsers and Arc, and for the coding-agent MCP server:
git clone https://github.com/lucianodiisouza/flecha-browser.git && cd flecha-browser chromium/scripts/install-native-host.sh --app /Applications/Flecha.app
Browsers can't read other browsers' files or open a local port, so Flecha ships a small native messaging host (a bundled Node, in the app). The script registers it with Chromium for Flecha's profile folder. It allows only Flecha's own shell extension to talk to it. Run it again if you move the app.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 192 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.
- # Flecha
- An Arc-style browser for developers, built on a Chromium fork. Arc's interface ideas are rebuilt from scratch; no Arc code is used.
- **Docs:** [flecha.dev/docs](https://flecha.dev/docs/)
- <p align="center"><img src="docs/screenshots/main-light.png" alt="Flecha's window: the sidebar with favourites, pinned tabs, Today and Spaces, beside a GitHub page"></p>
- ## Why
- Arc's vertical sidebar, Spaces and Peek are hard to give up, and Arc is no longer where the work is happening. Flecha is a replacement that keeps those ideas and adds tools for the people who build websites.
- It is a Chromium 158 fork rather than an Electron app because Google blocks sign-in in Electron. Flecha is real Chromium, so Google sign-in, Chrome Web Store extensions and the rest of the web platform work as they do in Chrome. Flecha started as an Electron app; that version is gone from the repo (it's in the git history before the move to `chromium/`).
- ## Features
- **Sidebar and tabs**
- - A vertical sidebar with favourites, pinned tabs (with folders) and Today tabs, per Space
- - Drag tabs between favourites, pinned, folders and Today
- - Pinned tabs and favourites reorder by dragging; favourites fill their row, with a ring in the Space colour on the active one
- - Folders from the sidebar (New Folder on the Pinned header, Move to Folder in the tab menu); folders drag, nest and have their own right-click menu. Folders and pinned tabs can take an emoji icon
- - Select several tabs with ⌘-click or ⇧-click: ⌘⇧C copies all their links, ⌥⌘C as a Markdown list
- - Today tabs archive themselves after 12 hours by default (1 day, 7 days, 30 days or never in Settings). Settings › Archive searches them, reopens one, forgets one or clears it
- - Closing a pinned tab or favourite only unloads it and sends it back to its pinned URL (double-click a favourite to do the same)
- - Per-site favicons, tab muting, duplicate, copy link, Markdown link or the selection as a quote, copy a screenshot or capture the full page, Reveal Tab in Sidebar
- - While a tab plays audio or video, a media card above the footer goes to it, pauses it or plays it
- - On launch, the window comes back where it was
- **Spaces**
- - Spaces with their own colour and emoji; in dark mode the colour becomes a deep tint of the same hue
- - New Spaces keep their own cookies and logins (a persistent storage partition per Space), so you can be signed in as different users side by side. The switch sits under the Space's name; imported Spaces share logins, so imported cookies still apply
- - Switch with ⌃1 to ⌃9, or next and previous Space with ⌥⌘← and ⌥⌘→
- - Reset Pinned Tabs puts a Space's pinned tabs back to their URLs; Spaces export to a file and import back (Settings › Tabs & Spaces)
- - Air Traffic Control (Settings › Tabs): rules that send links from other apps to a Space, by site or site and path
- **Command bar**
- <p align="center"><img src="docs/screenshots/command-bar.png" alt="The command bar suggesting MDN for the query mdn grid" width="720"></p>
- - ⌘T for a new tab, ⌘L for the current one; it searches open tabs, the archive and history
- - Developer shortcuts: `gh owner/repo`, `gh 123` (in the current tab's repo), `npm react`, `mdn grid`, `caniuse :has`, `so ...`, and `env`
- - Paste a JWT or a Unix timestamp to decode it in place
- - Type `boost` to open the Boosts page
- **Peek, split view and Flechinha**
- - Peek: links that open a new tab from a pinned tab or favourite show in a floating preview; any link's right-click menu offers it too. Esc or a click outside closes it, Open turns it into a tab
- - Split view: right-click a tab, Open in Split View, drag a tab onto another tab's row, or ⌃⇧= to split with a new tab (⌃⇧- exits). Swap Sides, or drag one half to the other side, swaps them
- - Flechinha: a small standalone window for a quick page (⌥⌘N), which can be sent back into the main window
- <p align="center"><img src="docs/screenshots/peek.png" alt="An MDN page open in Peek over the current tab" width="720"></p>
- <p align="center"><img src="docs/screenshots/split.png" alt="Hacker News and web.dev side by side in split view" width="720"></p>
- **Menu bar and windows**
- - Flecha's own menus: **Spaces** (switch, new, edit, separate logins, reset pinned tabs), **Tabs** (pin, folder, copy link, duplicate, mute, split, clear Today) and **Archive** (the last 10 archived tabs, and the whole archive). Chromium's Tab and Bookmarks menus are gone
- - Stay On Top (Window menu or the command bar) keeps the window above other apps' windows; Settings floats with it
- - Automatic picture-in-picture: a video that's playing moves to a floating player when you switch tabs or Spaces, on any site, and comes back when you return
- - ⌘S slides the sidebar out and back in
- **Boosts**
- - Per-site TypeScript and CSS (`github.com.ts`, `github.com.css`, `all.css`), kept in Flecha and edited on the Boosts page. CSS applies live; scripts reload the page. ⌥⌘B edits the current site's boost
- **For developers**
- - Console error badge: local tabs show how many console errors they have; clicking it opens the Console
- - Responsive view (⌥⌘M): the page as a phone (393px, touch, mobile user agent) next to desktop
- - Running locally: dev servers listening on this Mac show up in the sidebar, named after their project folder. The section collapses, × hides a port, and Settings › Tabs turns it off
- - Environments: group a project's origins (local, staging, production) in Settings; ⌥⌘E moves the page to the next one with the same path, and the address bar shows a LOCAL, STAGING or PROD badge
- - Chromium's DevTools (⌥⌘I), View source (⌥⌘U), zoom and Find in page
- - Coding agents (MCP): Settings, Coding agents turns on a local MCP server (127.0.0.1, token required) so Claude Code, Cursor and others can list tabs, read pages and console logs, take screenshots, click, type and run JavaScript. It needs the native host (see Install)
- **Privacy and the rest of the browser**
- <p align="center"><img src="docs/screenshots/main-dark.png" alt="Flecha in dark mode, with the Space colour turned into a deep tint" width="720"></p>
- - Built-in ad and tracker blocking (EasyList and EasyPrivacy as declarativeNetRequest rules, plus element hiding), toggled in Settings
- - Block third-party cookies, and clear browsing data by time range (Spaces with their own logins included)
- - Flecha keeps its encryption key in its own Keychain item, "Flecha Safe Storage", rather than Chromium's shared one, so a Mac with Chromium or another fork isn't asked to let Flecha into that app's key. Profiles from 0.1.3 or earlier carry the old key over once: macOS asks one time after the update (Always Allow), and you stay signed in
- - Incognito windows get the same Flecha frame, with one in-memory Space that is forgotten when the last incognito window closes
- - Import bookmarks, history and cookies (so you stay signed in) from other browsers, and Arc's sidebar (needs the native host): Spaces keep their colour and icon, and Spaces from other Arc profiles get their own logins. Chromium browsers' cookies are decrypted with the key in your keychain, so macOS asks first
- - Chrome extensions: install from the Chrome Web Store; their buttons appear under the address bar
- - Light, dark or system theme; Flecha's shortcuts can be re-recorded in Settings (except a few Chromium keeps, like ⌘T and ⌘W) (⌘/ lists them)
- - Settings (⌘,): importing from other browsers, search engine (Google, DuckDuckGo, Bing, Brave, Kagi, Ecosia), ad blocking, default browser, Peek behaviour, shortcuts, environments
- Not there yet in the Chromium build: choosing the downloads folder from Settings.
- ### Netflix, Disney+ and other DRM sites
- Flecha doesn't include Widevine, the DRM that Netflix, Disney+, Prime Video, Max, Hulu, Apple TV+, Spotify's web player and other streaming services require. Google only licenses Widevine to browsers that pay for a certification (VMP), and Flecha is free and open source with no paid parts. On those sites the sidebar says so once and offers to open the page in Safari. Everything else plays as in Chrome, including YouTube, Twitch and H.264/AAC video such as X's.
- ## Install
- 1. Download the latest `Flecha-<version>.dmg` from [Releases](https://github.com/lucianodiisouza/flecha-browser/releases) (or [flecha.dev](https://flecha.dev)). Flecha runs on **Apple silicon and Intel Macs**, macOS 13 or newer: take `Flecha-<version>.dmg` for Apple silicon (M1 and later) or `Flecha-<version>-x64.dmg` for Intel. Releases are signed with a Developer ID and notarized by Apple. Flecha keeps itself up to date with Sparkle.
- 2. Open the dmg and drag Flecha onto Applications.
- <p align="center"><img src="docs/screenshots/installer.png" alt="The Flecha disk image: the app beside the Applications folder" width="560"></p>
- Browsers can't read other browsers' files or open a local port, so Flecha ships a small native messaging host (a bundled Node, in the app) for importing from other browsers and Arc and for the coding-agent MCP server. Flecha registers it with Chromium for its profile folder each time it starts, so moving the app is fine. It allows only Flecha's own shell extension to talk to it. If Settings › Import or Coding Agents says the helper isn't registered, quit and reopen Flecha.
- ## Build from source
- You need:
- - macOS on Apple Silicon, with Xcode (and its command line tools)
- - [depot_tools](https://commondatastorage.googleapis.com/chrome-infra-docs/flat/depot_tools/docs/html/depot_tools_tutorial.html) on your `PATH`
- - a Chromium checkout at the version Flecha targets (158), with plenty of disk (100 GB or more) and several hours for a first build
- - Node 22.5 or newer (the native host uses `node:sqlite`) and `npm ci` at the repo root
- Fetching the Chromium checkout isn't scripted here; follow Chromium's [macOS build instructions](https://chromium.googlesource.com/chromium/src/+/main/docs/mac_build_instructions.md). Build on an APFS volume: `env.sh` expects the checkout on APFS because siso treats every output as stale on HFS+ (one-second file times) and rebuilds everything.
- `chromium/scripts/env.sh` says where things live, and every script reads it. Override with `CHROMIUM_SRC` (the checkout's `src`), `DEPOT_TOOLS`, `FLECHA_DISK`, `FLECHA_VOLUME` and `FLECHA_PROFILE` (the dev profile). Its defaults assume a disk image that it mounts for you, so set these for your own layout.
- ### The dev loop
- ```bash
- npm ci
- chromium/scripts/build.sh # apply.sh (branding and patches), then autoninja -C out/Dev chrome
- chromium/scripts/run.sh # launch out/Dev/Flecha.app with its own profile
- node chromium/shell/build.mjs # shell-only change: rebuild, then relaunch run.sh
- npm run typecheck
- ```
- `apply.sh` is safe to run again: it first resets every file it touches. The dev build is a component build, so a change relinks one small library. `run.sh` loads the shell from `chromium/shell/dist` through `--flecha-shell-dir`, so UI work needs no Chromium build at all (`npm run shell:watch` rebuilds on save).
- ### Release
- ```bash
- export FLECHA_SIGN_IDENTITY="Developer ID Application: Your Name (TEAMID)"
- export FLECHA_NOTARY_PROFILE=flecha-notary # made once with: xcrun notarytool store-credentials
- chromium/scripts/build-release.sh --dmg
- ```
- `build-release.sh` builds the shell, applies the patches, stages the shell into the checkout, writes `out/Release/args.gn` from `chromium/build/release.gn`, builds (3 to 6 hours, resumable) and calls `package-release.sh`. That copies the app, adds the native host with its Node, signs everything innermost first (hardened runtime, timestamp and Chromium's entitlements when `FLECHA_SIGN_IDENTITY` is set; ad hoc otherwise), makes the dmg with an installer window, and with `FLECHA_NOTARY_PROFILE` notarizes it and staples the ticket. Releases build for `target_cpu = "arm64"`; `FLECHA_ARCH=x64` builds the Intel app into `out/Release-x64` instead. Both include H.264 and AAC (`proprietary_codecs`, `ffmpeg_branding = "Chrome"`), since many sites only serve video in those formats.
- ## Repo layout
- ```
- chromium/
- patches/ the native changes to Chromium, as numbered unified diffs
- branding/ app icon, logo, BRANDING, the dmg background
- build/ dev.gn and release.gn (the GN args)
- scripts/ apply, build, run, env, build-release, package-release,
- install-native-host, dmg-layout.py
- shell/ the MV3 component extension that draws the window
- background.ts service worker: the Store, tabs, windows
- features/ ad blocking, boosts, console errors, local servers, responsive view
- ui/ sidebar, command bar, settings and Flechinha pages
- lib/ URLs, shortcuts, environments, settings rules, tab manager
- shared/ types and the sidebar model, used by the shell and the host
- native-host/ the native messaging host (Node)
- ```
- ## Architecture in brief
- Flecha is Chromium plus two layers: a small set of patches, and an extension that draws the browser.
- ```mermaid
- flowchart LR
- subgraph Chromium["Chromium 158 + Flecha patches"]
- Frame["Window frame view<br/>(hides tab strip and toolbar)"]
- API["chrome.flechaPrivate"]
- end
- subgraph Shell["Shell (MV3 component extension)"]
- BG["background.ts<br/>Store, tabs, features"]
- FP["Frame page<br/>sidebar, command bar"]
- end
- Host["Native host (Node)<br/>import, MCP server"]
- Frame -- "hosts" --> FP
- FP <--> BG
- BG <--> API
- BG <-- "native messaging" --> Host
- ```
- - **Patches** (`chromium/patches/`) change what only Chromium can: hide the tab strip and toolbar, draw Flecha's own window frame and traffic lights, round the page area, add Peek, Flechinha windows, split ratio, a storage partition per Space, and so on.
- - **The shell** is a Manifest V3 extension loaded as a component extension, so it can't be removed or turned off. Its service worker (`background.ts`) owns the Store and the tabs; everything the user sees is shell HTML and TypeScript.
- - **The frame page** is a shell page that Chromium's frame view hosts around the web contents. It draws the sidebar and command bar, and its drag regions move the window.
- - **`chrome.flechaPrivate`** (`shell/flechaPrivate.d.ts`) is the private extension API the patches add, for what the standard APIs lack: frame state, shortcuts, theme, split ratio, Peek, Flechinha, partitions, DevTools, the find bar and default-browser. It is available to the shell only.
- - **The native host** does what an extension can't: read other browsers' bookmarks and history, and serve MCP to coding agents on 127.0.0.1.
- ## Status and roadmap
- Flecha is early software, used daily by its author. Next:
- - Resizable split divider and 3 to 4 pane splits
- - Choosing the downloads folder in the Chromium build
- ## Contributing
- Bug reports and patches are welcome; see [CONTRIBUTING.md](CONTRIBUTING.md) for setup, how patches work, and the commit style.
- ## License
- Flecha's own code is released under the [MIT license](LICENSE). Flecha is built on [Chromium](https://www.chromium.org/); Chromium and its third-party components keep their own BSD-style and other licenses, and those notices apply to the browser builds. Flecha is not affiliated with or endorsed by Google, Arc or The Browser Company.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.