GrokLink OS logo
v3.4.0 · MIT Native · Not a Flipper fork Authorized research only

GrokLink OS

From-scratch research RTOS for portable multi-radio hardware — safety-gated agent, skills, and PC bridge.

View on GitHub Releases Docs & install
STM32WB55
Primary MCU target
Default-Deny
TX · GPIO · Contact · System
CC1101
SubGHz SPI (VERSION 0x14)
USB CDC
JSON-line RPC bridge
What it is

GrokLink OS is a complete research operating system — kernel, HAL, drivers, services, GUI, and safety path owned end-to-end. It is not an overlay or patch on Flipper Zero / Momentum / Unleashed firmware. A PC bridge (groklink-os) talks JSON RPC over USB CDC for status, passive RX, skill craft, and human-gated control.

GrokLink RTOS Policy engine GrokAgent missions Hot-load skills ST7567 GUI Host simulation
Design principles
  • Safety by construction — actuators only via policy
  • Determinism under load — pools, budgets, fail closed
  • Constrained autonomy — offline missions under policy
  • Audit everything — append-only, hash-chained
  • Modular skills — risk-classed, optionally signed
  • Honest silicon — capability without false claims
Architecture layer cake
PC BRIDGE
groklink-os · async RPC · craft · stream · vault tools · USB CDC / BLE GrokRPC
APPLICATIONS
Shell · ST7567 status UI (HOME / RADIO / SAFETY / ABOUT) · factory diagnostics
SERVICES
Policy · agent · skill host · RPC · audit · storage · power · radio arbiter
DRIVERS
SubGHz (CC1101) · NFC · IR · GPIO · iButton · UART/SPI/I2C · BLE wrappers
HAL + KERNEL
Portable HAL · GrokLink RTOS (tasks · mutex · queue · timer · mempool · tick)
PLATFORM BSP
Host simulator · stm32wb55 board · future MCU ports
Safety model
info
Status, skill list — lower friction, audited when configured
passive_rx
SubGHz / IR / NFC listen — edu session, freq window, rate limits
active_tx · gpio · contact
Confirm token, blacklist, duty cycle, power cap, audit
system
Reboot / rekey — edu + physical on-device OK + audit
Edu ack phrase Confirm tokens (TTL) Freq / pin blacklists Duty cycle limits Hash-chained audit
v3.1 status
USB CDC JSON RPC
Live on device — deferred RPC (USB-safe)
CC1101 SubGHz probe
Bit-bang SPI_R · VERSION 0x14
On-device GUI
ST7567 pages · Left/Right navigate
Policy default-deny TX
Gated actuators · host tests
Full SD + offline agent
Roadmap — missions / skill host complete path
Agent + skill loop (authorized lab)
1
Connect
Install bridge · open CDC · ping device
2
Edu ack
Session phrase · authorized targets only
3
Passive RX
Owned band listen · short dwell · log
4
Craft skill
Capture → draft skill · human review
5
Gate TX
Confirm token · never auto-TX
Hardware focus
CC1101 SubGHz
SPI_R bit-bang · probe / RX path · deferred radio worker
ST7567 display
HOME · RADIO · SAFETY · ABOUT status pages
USB DFU + CDC
Flash GrokLink-OS DFU · 230400 baud JSON lines
GrokAgent + skills
Mission IR · risk classes · hot-load manifests
PC bridge quick start
# clone & install
git clone https://github.com/Pitchfork-and-Torch/GrokLink-OS.git
cd GrokLink-OS/bridge
pip install -e .

# session
groklink-os ping
groklink-os edu-ack
groklink-os status
groklink-os rx --freq 433920000 --ms 500
System poster
GrokLink OS architecture infographic — stack, safety model, agent loop, and legal boundary

Open source on GitHub

Clone the firmware, run host tests, install the bridge, and flash lab DFUs from the public repo. MIT licensed · Pitchfork-and-Torch.

github.com/Pitchfork-and-Torch/GrokLink-OS Read the README
Legal / ethical

For authorized research, education, and equipment you own (or are explicitly authorized to operate on). Unauthorized RF / IR / RFID / NFC / access-control interference may be a crime. Not a medical device. Authors accept no liability for misuse.

I_WILL_USE_ONLY_AUTHORIZED_TARGETS