Repository navigation
Releases
riskell 0.2.1
riskell 0.2.0
Licensing
- The application moves from PolyForm Noncommercial 1.0.0 to the Functional Source License 1.1, MIT Future License (
FSL-1.1-MIT). Work use
and company use are now allowed; a paid product built on riskell is not, for two years, after which each release is MIT.LICENSING.md
answers the common questions in a table, and the trademark andriskell.registry-namespace limits are stated there. Releases0.1.0to
0.1.2stay under PolyForm Noncommercial.risk extaccepts both FSL identifiers as known SPDX licenses. - The bundled atom packages carry
FSL-1.1-MITin their headers and manifests, sorisk ext validatefinds no unknown license in them.
Documentation
README.mdrebuilt: a centred title block with the tagline and status in one line, a "Why another bar" comparison before the install step, a
2×2 picture grid for the tour, headings that can be scanned as a list of claims, and the deep material moved into collapsed sections.docs/STOREFRONT.mdno longer claims a capability report that does not exist, and says plainly what the storefront cannot know (no install
counter, no telemetry, and why GitHub Pages offers no logs). Previews are no longer listed as unbuilt.- The documentation was checked against the code as a whole. Corrected: the top bar cannot be switched off,
risk extgainedsearch,info,
updateandpublishin three lists that predated them,config.jsonnamed neithergesturesnordisplayand omittedaerospace,
Compat.Verifieddoes not hold the protocol number or a build hash, the memory figure disagreed withdocs/EFFICIENCY.md, the live-reload
claim ignoredwm,scaleanddisabledExtensions, the atom count is ten in seven packages, and the paused-media window is 15 minutes.
The panel is called riskell preferences everywhere, and the six longest documents have a contents line.
riskell 0.1.2
Fixed
risk installended silently, with no launch agent, on a Mac without ariskell-devsigning certificate (every new install). The certificate is
optional: the bundle is now signed ad hoc when there is none, andrisksays so. macOS asks again for keychain and Location access after a rebuild.risk installfailed writing its launch agent on an account with no~/Library/LaunchAgentsfolder yet. The folder is created.riskell-install(the Homebrew link toinstall.sh) did not find the guided installer orscripts/riskwhen run through the symlink, and fell back
to a quick install that pointed at a path that does not exist. It now resolves its own location through symlinks.
riskell 0.1.1
Added
- Two opt-in AI usage sources, both off by default and never enabled by
--yesalone.usage.claudeLimitsshows your plan's real Claude limits: it
reads the Claude Code login token from the login keychain and asks Anthropic's usage endpoint. This is unofficial: Anthropic's terms do not allow
using that token in other tools, so the account could be restricted.usage.opencodeshows OpenCode Go usage: it reads the console session cookie
from a Firefox-family browser profile inside your home folder (a private temporary copy, removed afterwards) and asks the OpenCode console, which
is not a published API. Requests go over https toapi.anthropic.comandopencode.aionly, with no cross-host redirects; secrets are never
logged or cached. The installer has a step for each, with a panel that says what is read and sent and needsyto accept
(--claude-limits,--opencode-workspace,--opencode-profilesfor scripts). Seedocs/CONFIG.md.
Fixed
- AI usage no longer shows a percentage it cannot know. Claude Code's local logs have token counts but not your plan's limits, so a percentage was
only "of your own peak" and read 100 % whenever you were at it. Withoutusage.fiveHourTokens/usage.sevenDayTokensinconfig.jsonthe atom
and card now show the tokens used (the running 5-hour session and the last 7 days); with them, a real percentage, as before. - The three-finger swipe could end up reversed until riskell restarted: its direction was guessed from the first Space change after a swipe, and a
Space change from another cause close to a swipe taught it the wrong way. The direction now follows System Settings > Trackpad > Natural scrolling,
read each time, and a Space that moves against a swipe is only noted in the log.
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.