Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 22 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0

## [Unreleased]

### Documentation

- Updated the README, standalone website, manual, story, and user guide for the
OCI computer generation shipped in 0.0.29/0.0.30: Linux uses native Podman,
Windows uses one managed WSL 2 runtime with a container per channel, and
OCI storage is authoritative.
- Scoped release-security claims by platform. Mac artifacts are signed and
notarized, Linux assets are digest-verified, and Windows Authenticode status
is disclosed honestly (`NotSigned` for v0.0.30).
- Documented the current desktop choice between hosting a new workspace and
connecting to an existing HTTPS host, plus host-neutral domains and mobile
gateway behavior.
- Brought the manual up to date with the Captain-to-Skipper Texts model and the
Cowork HTML preview, generated-deck layout, direct folder navigation, live
work status, automatic file refresh, and per-file session history already
present in v0.0.30.
- Removed false current-mobile distribution claims: v0.0.30 has no Android APK,
and 1Helm is not currently listed in the public iOS App Store. The current
phone/tablet path is the HTTPS browser interface.
- Retired the stale pre-OCI demo claim. `demo.1helm.com` now redirects to the
product site until a new isolated sandbox is deliberately provisioned.

## [0.0.30] - 2026-07-31

### Fixed
Expand Down
55 changes: 29 additions & 26 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,8 +18,6 @@
 · 
<a href="https://1helm.com/manual/install-linux"><strong>for Linux</strong></a>
&nbsp;·&nbsp;
<a href="https://github.com/gitcommit90/1Helm/releases/latest"><strong>for Android</strong></a>
&nbsp;·&nbsp;
<a href="https://1helm.com">The story</a>
&nbsp;·&nbsp;
<a href="https://1helm.com/manual">Ship's manual</a>
Expand All @@ -33,8 +31,8 @@
<code>AGPL-3.0-only</code>&nbsp;&nbsp;
<code>Self-hosted</code>&nbsp;&nbsp;
<code>Model-agnostic</code>&nbsp;&nbsp;
<code>Signed + notarized</code>&nbsp;&nbsp;
<code>macOS · Windows · Linux · iOS · Android</code>
<code>Apple signed + notarized</code>&nbsp;&nbsp;
<code>macOS · Windows · Linux</code>
</p>

---
Expand Down Expand Up @@ -138,11 +136,12 @@ it works best on a dedicated machine: your crew works around the clock, and
your everyday computer takes naps.

Mac, Linux, and Windows use one synchronized desktop release version. A release
is held in full until the DMG/updater ZIP, Linux host archive, and signed
Windows Setup/Squirrel feed have all passed native install and update
acceptance from the same source commit.
is held in full until the signed/notarized Mac DMG and updater ZIP, verified
Linux host archive, and Windows Setup/Squirrel feed have all passed native
install and update acceptance from the same source commit. Windows
Authenticode status is disclosed in every release; v0.0.30 is `NotSigned`.

### Connect from iPhone, iPad, or Android
### Connect from a phone or tablet

The mobile apps are thin, native gateways to a 1Helm you already run. Install
and finish setup on a supported Mac, Windows, or Linux host first, give that
Expand All @@ -152,12 +151,11 @@ Android always use the same current interface. Sign-in happens on that live
frontend; the password is never retained and the resulting session is stored
in the iOS Keychain or encrypted with a key held by Android Keystore.

- iPhone and iPad use the App Store build under the stable bundle identifier
`com.gitcommit90.onehelm.mobile`.
- Android is distributed directly as `1Helm-<version>-universal.apk` on the
matching GitHub Release. Android may ask you to allow installs from the app
you used to open the file. Verify the release SHA-256 and install it; future
releases signed by the same permanent 1Helm certificate install in place.
- The native iOS and Android gateway source is included in this repository,
but neither mobile platform has a current v0.0.30 public build. The most
recent signed Android APK is the older v0.0.23 gateway, and 1Helm is not
currently listed in the public iOS App Store. Use the HTTPS browser interface
for the current v0.0.30 experience.
- The native clients require HTTPS, do not contain or initialize the 1Helm
server or a frozen copy of its product frontend, and do not retain host data
or provider credentials beyond the selected server address and secure
Expand Down Expand Up @@ -244,7 +242,7 @@ and an audit trail. A prompt saying “use this service” is not a connector.

## What ships now

- Captain → Providers → Workspace onboarding in the signed Mac app.
- Captain → Providers → Workspace onboarding on every supported host.
- Exactly one resident for every ordinary channel and one Skipper in `#main`.
- A persistent, fully isolated Linux computer per ordinary channel on every
supported platform (exact contracts in the table below).
Expand All @@ -257,10 +255,14 @@ and an audit trail. A prompt saying “use this service” is not a connector.
`/workspace/whiteboards`, `/workspace/code`, `/workspace/docs`, and
`/workspace/presentations`, with one consistent file rail, live collaborative
text editors, embedded whiteboard and slide canvases, and an optional
channel-agent panel that starts an ordinary thread with the open file path.
channel-agent panel with live work status and per-file session history.
- Cowork Code can preview an HTML file with its same-project CSS and JavaScript
in a sandbox; agent-created files appear without a reload, and folders open
directly from the shared rail.
- Presentations define a visible, locked printable area (1500 × 1000 by
default), allow custom page dimensions, and export the complete bounded slide
deck as one multi-page PDF while excluding work outside each page.
deck as one multi-page PDF while excluding work outside each page. Simple
agent-generated decks receive a themed, wrapping, content-aware layout.
- Quick Note in the top bar for capturing a Markdown note into
`/workspace/notes` without leaving or repositioning the current channel view.
- Durable files, threads, curated memory, Mnemosyne long-term recall,
Expand All @@ -269,12 +271,13 @@ and an audit trail. A prompt saying “use this service” is not a connector.
- Outcome-first Activity with expandable work evidence and a tamper-evident
SHA-256 chain for new operational events.
- Local-first collaboration through an optional workspace domain routed to the
Captain's Mac; workspace state and provider credentials remain on that Mac.
- Host-owned updates: a signed native Mac updater plus an atomic,
digest-verified Linux system service with health-check rollback.
Captain's helm host; workspace state and provider credentials remain there.
- Host-owned updates: a signed native Mac updater, a Windows Squirrel feed with
disclosed Authenticode status, and an atomic digest-verified Linux system
service with health-check rollback.
- Signed, Apple-notarized, stapled Apple Silicon DMG releases.
- Native iPhone/iPad and directly distributed Android gateway clients for an
already configured HTTPS 1Helm host.
- Browser access from phones and tablets to an already configured HTTPS 1Helm
host; native mobile gateway source is present but has no v0.0.30 public build.

### Platform truth

Expand All @@ -283,11 +286,11 @@ and an audit trail. A prompt saying “use this service” is not a connector.
| **Apple Silicon macOS 26** | Native desktop product and real isolated Linux computer per resident (Apple `container machine`, `home-mount=none`). |
| **Linux / CI** | Supported headless systemd host with one durable Podman OCI container per resident, runtime-owned storage, and exact ownership checks; CI may select an explicit test backend. |
| **Windows 11 x64** | Native desktop product with one installation-scoped WSL 2 OCI runtime and one durable container per resident; Windows-drive mounts and interop are disabled. |
| **iPhone and iPad** | App Store gateway to an already configured HTTPS 1Helm host; sessions live in the device-only iOS Keychain. |
| **Android 7+** | Directly distributed signed universal APK gateway; sessions are encrypted by a key held in Android Keystore. |
| **iPhone, iPad, and Android** | Use the current HTTPS browser interface. Native gateway source exists, but v0.0.30 has no public mobile artifact and the iOS app is not publicly listed. |

Not yet shipped: a native Linux desktop shell, a hosted control plane, rich
Photon attachment fidelity, or blind execution of community skills.
Not yet shipped: current public mobile builds, a native Linux desktop shell, a
hosted control plane, rich Photon attachment fidelity, or blind execution of
community skills.

## Run the source workspace

Expand Down
25 changes: 16 additions & 9 deletions docs/USER_GUIDE.md
Original file line number Diff line number Diff line change
Expand Up @@ -128,11 +128,14 @@ Whiteboard, Code, Docs, and Presentations modes map directly to:
Each mode keeps the same folder rail and nested-folder navigation while the
center changes to the appropriate editor. Notes and Docs use collaborative
Markdown editors with formatting and preview; Code adds line numbers, search,
indentation, and language-aware highlighting while declining unsupported
indentation, language-aware highlighting, and a sandboxed HTML preview that
loads same-project relative CSS and JavaScript while declining unsupported
binary types. Whiteboard embeds a collaborative Excalidraw canvas in one
readable `.whiteboard.json` file. Presentations use one readable `.slides.json`
file with an Excalidraw-backed slide canvas, thumbnails, reordering, and
presentation mode. Drafts and each mode's last open asset remain available
presentation mode. Simple generated decks receive a themed layout, wrapping,
bullet spacing, and font step-down rather than raw text boxes. Drafts and each
mode's last open asset remain available
while switching modes. Opening one of these assets from Files routes to the
matching Cowork mode because both surfaces edit the same bytes.

Expand All @@ -147,8 +150,10 @@ asset on desktop. Its first message starts a normal channel thread and adds the
current `/workspace/...` path. When other people are actively viewing that
asset, their usernames are included with the first message so the normal
thread can include the current collaborators. Later messages continue that
thread, and **Open in Chat** moves the same session to the channel's regular
conversation view. The agent harness otherwise remains unchanged.
thread. The panel shows one current work status, refreshes newly created files,
and lets you reopen past sessions for the current file or folder; **Open in
Chat** moves the same session to the channel's regular conversation view. The
agent harness otherwise remains unchanged.

The terminal prompt displays the live current path and changes after `cd`.
1Helm sends a terminal heartbeat while the pane is open and automatically
Expand Down Expand Up @@ -332,9 +337,10 @@ Open-Terminal endpoints. Residents never receive these computers.

## Domains, collaboration, members, and privacy

The installed Mac can reserve a local-first `1helm.com` workspace address and
optionally connect a Cloudflare domain. The Mac remains the only workspace
server; sleeping or shutting it down makes the workspace unavailable.
The installed helm host can reserve a local-first `1helm.com` workspace address
and optionally connect a Cloudflare domain. That Mac, Windows PC, or Linux host
remains the only workspace server; sleeping or shutting it down makes the
workspace unavailable.

Public registration closes after the Captain account. Access requests appear in
Settings → Members and create an LLM-independent notice in the Captain's
Expand Down Expand Up @@ -437,8 +443,9 @@ fallback.
- Agent interviews have a narrow human-only policy.
- External skills are revision-pinned, bounded, scanned, hashed, and wrapped.
- Operational history is locally tamper-evident.
- Signed releases are Developer ID signed, notarized, stapled, and Gatekeeper
verified before publication.
- Mac artifacts are Developer ID signed, notarized, stapled, and Gatekeeper
verified. Linux assets are digest-verified, and Windows Authenticode status
is disclosed for every release (`NotSigned` for v0.0.30).

For the detailed boundary, see [SECURITY.md](../SECURITY.md). For product intent,
see [VISION.md](VISION.md).
13 changes: 8 additions & 5 deletions docs/VISION.md
Original file line number Diff line number Diff line change
Expand Up @@ -83,14 +83,17 @@ verification.
## Product truth

- `https://1helm.com` is the standalone product and documentation site.
- `https://demo.1helm.com` is a separate public sandbox, not the product site
and not a dependency of an installed workspace.
- `https://demo.1helm.com` currently redirects to the product site. The retired
pre-OCI sandbox was removed during the clean-start runtime transition; a
future sandbox must be provisioned explicitly with isolated non-production
state before it is advertised again.
- Apple Silicon macOS, Linux systemd, and native Windows x64 + WSL are the
synchronized public desktop-host product. Every named desktop release must
publish all three from one version and exact source commit.
- 1Helm is self-hosted and open source. A hosted control plane, mobile clients,
blind community-skill execution, and a native Linux desktop shell are not
shipped.
- 1Helm is self-hosted and open source. Native mobile gateway source is present,
but v0.0.30 has no public Android/iOS build and 1Helm is not listed in the
public iOS App Store. A hosted control plane, blind community-skill execution,
and a native Linux desktop shell are not shipped.

## What 1Helm borrows—and what it does not

Expand Down
Loading
Loading