Repository navigation
riskell 0.1.0
Security
- The AI usage atom reads no credential and makes no network request: it computes the Claude meters from Claude Code's own local session logs (token
counts; an active 5-hour session and the last 7 days, measured against limits you set inconfig.jsonor your own 30-day peak). The first version
read the Claude Code OAuth token from the keychain and called an unofficial Anthropic endpoint, which Anthropic's terms do not allow for third-party
tools, and a provider that copied a browser's cookie database; both were removed before release, along with the OpenCode provider. risk ext addandupdateare strict about what they install: https repositories only (git'sext::transport, prompts and hooks are off), every
field of a listing is checked, a pill or theme file must be a plain small regular file inside the repository, the registry index is fetched over
https only, and installing someone else's code or a pill's shell commands needs your confirmation after you are shown the author, license, commit
and commands (--yesfor scripts).- GitHub Actions are pinned to commits and run with a read-only token; Dependabot, CODEOWNERS and
scripts/harden-github(secret scanning, push
protection, private vulnerability reporting, fork-PR approval) are set up;SECURITY.mdsays what is built in and how to report. scripts/releasemakes a release only from a clean, checked main;riskell --versionandscripts/version-check.shkeep one version number.
Licensing
- The app is source-available under the PolyForm Noncommercial License 1.0.0; RiskellKit,
risk ext, the schema and the examples are
Apache-2.0. Contributions need a CLA. Added a Code of Conduct and a security policy.
Added
-
RiskellKit, a separate repository: the design tokens, the drawing primitives, the reading renderer, the popout
hook and the extension API (ReadingAtom,CustomAtom,Env, feeds). Extensions depend on it alone. -
Extensions: compiled packages linked into the one binary through
extensions.lock.json; atoms are placed asext:<id>. -
risk ext:validate,new,add,remove,list,sync. -
schemas/riskell-extension.schema.json,AGENTS.md,docs/WRITING-EXTENSIONS.md,Examples/load-ext. -
riskell preferences: the layout editor is renamed, and an extension declares typed settings (
settingsinriskell.json: number, bool,
choice) that appear in its EXTENSIONS card and apply at once.risk ext validatechecks them;riskell --ext-selftesttests the write and rebuild. -
listings/: one registry listing for each built-in atom,schemas/riskell-listing.schema.json,riskell --list-atomsand
scripts/listings-check.sh, which keeps the listings in step with the app.
Added (the storefront)
-
risk ext search,info,add <name>,update [--yes]andpublish: extensions are found in a registry (riskell-registry, listings pinned to a
commit, anindex.jsonthe client reads,RISKELL_REGISTRYto point elsewhere) and installed at the pinned commit; the manifest must agree with the
listing. Pills and themes are files copied into the config folder and applied live (~/.config/riskell/extensions.jsonrecords them).update
shows the change between the two commits and applies only with--yes.riskrebuilds only whenriskell-extexits 10. -
The registry repository: listing schema,
scripts/check-listing.py, the index and storefront page builders, and CI (pull-request checks and GitHub Pages). -
Storefront pictures: listings carry a
previewPNG (the manifest'spreview, checked byrisk ext validateandpublish);scripts/make-previewsrenders them with riskell, for what ships with it
(docs/images/store/).
Fixed
risk ext newscaffolded extensions that depended on RiskellKit 1.0, which does not exist, so they could not build; they now depend on the kit's
current minor (.upToNextMinor(from: "0.6.0"),"kit": "^0.6"), as doesExamples/load-ext.
Changed
- Workspaces and the application icon are a package too (
Packages/windows;ext:workspacesandext:appicon; older layouts are read as them), so
every atom that ships with riskell is a package on the kit and the application has no built-in atoms left. RiskellKit 0.6.0 addsWindowsModel
(WorkspaceInfo,WindowInfo),RailStateandWindowActionsfor the window manager,PopState.chatandsetHoldOpen, and
KitHost.screenHeight. The overview and the window-manager backends stay in the application. - Volume and network are packages too (
Packages/volume,Packages/network;ext:volandext:net; older layouts are read as them). The volume
package owns the CoreAudio readers, the mixer taps and the microphone; the network package owns the Wi-Fi service (a Location grant restarts riskell
through the kit's newAppHooks) and the live network card. RiskellKit 0.5.0 addsView.onScrollStepsandAppHooks.restart. The application's
Syskeeps only the battery and volume that the.batteryand.volumefeeds read, started by their first subscriber, and theNeedstable has
no atom rows left. The network card reads its tab from--pop net:<n>itself. - Battery, CPU and fans are one package,
Packages/system(ext:bat,ext:cpu,ext:fan; older layouts are read as them). The package owns its
samplers (CPU and memory, the smart battery, the SMC, the process list) behind one engine that runs only while one of the three is on a showing bar.
RiskellKit 0.4.0 addsPopState.setKeyableandrefit,View.onRightClickandDemo(the screenshot placeholders). The application's ownSys
now reads only the battery and the volume, with no timer. - An atom that draws nothing until its data arrives is now started: the host gives every custom atom a zero-size anchor, because an empty view never
"appears". An extension subscribed to a feed keeps the service behind it running. - Weather and AI usage are packages too (
Packages/weather,Packages/usage, placed asext:weatherandext:usage; older layouts are read as
them). They read the location and the usage providers fromconfig.jsonthrough the kit's newenv.config, keep their caches inenv.cache, and
start only while on a showing bar. RiskellKit 0.3.0 addsHostConfig,Env.config,Env.cache,PopState.openand.close(), and
CustomAtom.isBlank(_ env:). The weather forecast parser keepsriskell --weather-selftest. - The clock is the first built-in atom to move out of the application: a package,
Packages/clock, installed byextensions.lock.jsonand placed as
ext:clock(an older layout.json that saysclockis read as it). The look is unchanged. RiskellKit 0.2.0 addsPopStatefor its
two-stage date card. The clock now ticks only while it is on a showing bar, and the app's own minute timer wakes once a minute, not once a second. - A custom atom's horizontal form hugs its content (at most
maxWidth) instead of growing to the room the bar offers. - Built-in services (CPU, battery, volume and microphone, thermals, weather, Wi-Fi, AI usage) start only while an atom that needs them is
placed on a bar that is on, and stop when it is removed (Services/Needs.swift). A layout with no weather or network atom makes no request,
and asks for no Location access. - Script pills and extension readings are drawn by the same code (the kit's
ReadingBodyandReadingCardContent). No pixel changed.
Documentation
- A README with a full feature list, screenshots of everything, and a roadmap. The pictures come from
scripts/make-screenshots, which
renders them from fake data (a made-up wallpaper, fake workspaces, placeholder device and process names) so they can be made again.
Fixed
- The overview is resolution-independent: every size in it follows the one scale factor, and it follows display changes.
- The weather card footer showed a hardcoded city; it now shows the place from
config.json. - Script pills (and extension atoms) no longer run while their bar is switched off or hidden by a fullscreen Space.