Stahl Capital: GUI application built with portfolio_rs
  • Rust 91.2%
  • JavaScript 2.3%
  • Swift 1.9%
  • HTML 1.6%
  • CSS 1.5%
  • Other 1.5%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-11-16 08:46:13 +01:00
.github ci: build without secrets, then sign; the signing key is imported non-extractable 2026-11-15 01:00:04 +01:00
assets feat: make the steel door the icon 2026-11-07 11:15:26 +01:00
examples fix(site): render the landing media with AI on and no opening door 2026-11-14 21:05:17 +00:00
ios chore(deps): bump zip from 9.5.0 to 9.5.1 in /ios/rust 2026-11-15 11:43:20 +00:00
screenshots screenshots: regenerate after the risk fixes and the look tickets 2026-11-14 15:00:28 +01:00
scripts ci: update Rune with one script, weekly, and let Dependabot see ios/rust 2026-11-09 10:54:31 +01:00
site feat(site): an iOS tab with the TestFlight beta, and the hero links there on iPhone and iPad 2026-11-16 08:46:13 +01:00
src test(update): the real-release check fails without a disk image, and checks the updater's own ditto copy 2026-11-15 07:39:17 +01:00
tests fix(site): render the landing media with AI on and no opening door 2026-11-14 21:05:17 +00:00
.envrc initial commit 2026-07-06 13:03:59 +02:00
.gitignore ci: refuse signing material and secrets in the repo 2026-11-14 16:11:43 +01:00
AGENTS.md ci: update Rune with one script, weekly, and let Dependabot see ios/rust 2026-11-09 10:54:31 +01:00
Cargo.lock chore(deps): bump zip from 9.5.0 to 9.5.1 2026-11-15 11:42:57 +00:00
Cargo.toml chore(release): 0.5.0 2026-11-14 20:06:27 +01:00
DESIGN.md feat(counsel): the question settles in, and the new motion written down 2026-11-14 15:00:28 +01:00
flake.lock chore(deps): update Rune to 2bdfae1, the flake and both lockfiles 2026-11-09 10:54:01 +01:00
flake.nix fix(nix): keep the intake test files in the source the checks build 2026-11-14 15:00:28 +01:00
LICENSE initial commit 2026-07-06 13:03:59 +02:00
README.md fix(update): say why a signature was refused, and test the check against a real release 2026-11-15 01:00:04 +01:00
rust-toolchain.toml feat: rewrite Stahl natively on Rune (#48) 2026-11-06 17:54:26 +01:00

Stahl Capital

CI

A desktop app for portfolio_rs. Track what you own, see how it got there, check it against your investment policy, and try out a rebalance before you do it. Your data stays in plain files on your machine. Written in Rust on Rune, with no web view. Runs on macOS, Linux and Windows, and on iPhone and iPad (ios/).

More at zoppelt.net/stahl. It's early, so expect rough edges.

Overview

Holdings Allocation
Performance Review
Rebalance Command palette

Getting started

Install it with Nix, or grab a .dmg, .deb or Windows .zip from Releases:

nix run github:MarkusZoppelt/stahl              # try it
nix profile install github:MarkusZoppelt/stahl  # keep it

The macOS build is signed with a Developer ID and notarized by Apple, so it opens like any app. On Linux you need a Vulkan driver (mesa-vulkan-drivers on Debian and Ubuntu).

On first launch, create a workspace. That's a folder in the same format as portfolio_rs init-workspace, with your positions, your policy and its history in it. You can also open a single positions file (stahl positions.json), but Review, Rebalance, Policy and Documents need a workspace. If you're lost, press ⌘/ for the guide, or ⌘K for everything else (Ctrl on Linux and Windows).

Welcome Guide

What leaves your machine

  • Your tickers, to Yahoo Finance, for prices. PORTFOLIO_RS_QUOTES=offline stops that.
  • Whatever you send an AI provider, if you add one in Settings. There's none by default.
  • One request to api.github.com on launch, to see if there's a newer release. GitHub sees your IP and the version asking, nothing else. STAHL_NO_UPDATE_CHECK=1 skips it.

No account, no telemetry. Nothing is downloaded until you say so.

When you do, how it updates depends on how you installed it. The .dmg (Apple Silicon) and the Windows .zip replace themselves and restart. The .deb is downloaded and checked, and you get the sudo apt install command to run. Nix, source builds and anything else just get a link to the release.

Downloads must match the SHA-256 checksum published next to them. That catches a broken download, not a compromised release, since whoever can replace one can replace the other. On macOS the new app must also be signed with Stahl's Developer ID, which a tampered release can't forge; the Windows .zip and the .deb rely on the checksum alone. If that matters to you, verify releases yourself or use Nix.

History

Stahl records one valuation a day when it opens a portfolio or refreshes prices, if every position has a price. It writes the same file as portfolio_rs snapshot, so both add to one history: portfolio/history/main/snapshots.jsonl in a workspace, otherwise $XDG_DATA_HOME/portfolio_rs/main/snapshots.jsonl (or PORTFOLIO_RS_DATA_DIR). Encrypted (.gpg) portfolios are never recorded, so their values don't end up on disk in plaintext.

Beside that file, seen.json holds the last two days you opened the portfolio, and nothing else, so the Overview can say what changed since you last looked. It holds only dates, so it is kept for encrypted portfolios too.

Building

nix develop          # the pinned toolchain
cargo run
cargo run --example demo   # a made-up portfolio, no network
nix flake check      # what CI runs: build, clippy, fmt, tests

Without Nix, rustup picks up rust-toolchain.toml. Linux also needs libxkbcommon-dev libwayland-dev to build.

AGENTS.md is the guide to working on it, for people and AI agents alike, and DESIGN.md is how it looks. Most of the actual portfolio logic lives in portfolio_rs.

To release, bump the version in Cargo.toml, merge, and push a matching tag (v0.4.0). .github/workflows/release.yml builds the installers and publishes them with their checksums.

The macOS app and disk image are signed with a Developer ID and notarized by rcodesign, and a tag fails without these repository secrets:

  • DEVELOPER_ID_P12: the Developer ID Application certificate and its key, as a base64 .p12
  • DEVELOPER_ID_P12_PASSWORD: the password it was exported with
  • ASC_KEY_ID, ASC_ISSUER_ID, ASC_KEY_P8: an App Store Connect API key (the .p8 as is)

A pull request always builds ad-hoc signed. A manual run signs and notarizes but publishes nothing.

Every push to main also builds the iPhone and iPad app and uploads it to TestFlight (.github/workflows/testflight.yml), signed with the Apple Distribution certificate: DEVELOPER_ID_P12 and DEVELOPER_ID_P12_PASSWORD (the same private key), DISTRIBUTION_CER, APPSTORE_PROFILE, APPLE_TEAM_ID and the same API key. A missing one fails the run.

License

MIT. See LICENSE.