A Get started with OxygenHub walkthrough (0.9.0) b1047516e064

Sign in, proposals and issues, proposing a bookmark, Flow and the inbox,
each ticking itself off as it is done.

closes #3

Author: Andy McCall @andymccall <[email protected]>
When: 1 month ago · 2026-09-29 18:38 UTC
Signature: ✔ signed by Andy McCall
Hash: b1047516e0643c3250ded6f18fad3ac6c86edf0476be548a71df4e67a70f52e8
Depends on: 092b8bf9f2ac 263de209e5ba f0b06deac4b9
Depended on by: bd69712343d2
In bookmarks: main
In tags: v0.10.0 v0.10.1 v0.10.2 v0.11.0 v0.11.1 v0.11.2 v0.13.0
Edits: 9 atoms, 6 tree operations, 7 files

Browse the tree at this change

show whitespace changes

added walkthrough/flow.md +3 −0

added walkthrough/inbox.md +3 −0

added walkthrough/proposals.md +3 −0

added walkthrough/propose.md +3 −0

added walkthrough/signin.md +3 −0

modified CHANGELOG.md +4 −0

modified package.json +65 −1

1	1		# Changelog
2	2
	3	+	## 0.9.0 (2026-09-29)
	4	+
	5	+	- Get started with OxygenHub. A walkthrough on the Welcome page covers signing in, proposals and issues, proposing a bookmark, watching Flow and the inbox. Each step ticks itself off as you do it.
	6	+
3	7		## 0.8.0 (2026-09-29)
4	8
5	9		- Flow view. The OxygenHub sidebar shows each repository's recent OxygenFlow runs and their jobs.
		…	67 unchanged lines

		…	1 unchanged lines
2	2		"name": "oxygenhub-vscode",
3	3		"displayName": "OxygenHub",
4	4		"description": "Proposals, reviews, issues and checks from an OxygenHub, in the editor. Builds on the Oxygen extension.",
5		-	"version": "0.8.0",
	5	+	"version": "0.9.0",
6	6		"publisher": "andymccall",
7	7		"license": "MIT OR Apache-2.0",
8	8		"icon": "assets/images/oxygenhub.png",
		…	458 unchanged lines
467	467		"highContrast": "#35c7ff",
468	468		"highContrastLight": "#0a5a8f"
469	469		}
	470	+	}
	471	+	],
	472	+	"walkthroughs": [
	473	+	{
	474	+	"id": "oxygenhub.gettingStarted",
	475	+	"title": "Get started with OxygenHub",
	476	+	"description": "Sign in, propose and review, and watch OxygenFlow from the editor.",
	477	+	"steps": [
	478	+	{
	479	+	"id": "oxygenhub.signin",
	480	+	"title": "Sign in to your hub",
	481	+	"description": "A hub URL and a personal access token (Settings \u2192 Tokens on the hub). A self-signed hub works too: the extension uses the CA your checkout's remote names.\n[Sign In](command:oxygenhub.signIn)",
	482	+	"media": {
	483	+	"markdown": "walkthrough/signin.md"
	484	+	},
	485	+	"completionEvents": [
	486	+	"onCommand:oxygenhub.signIn"
	487	+	]
	488	+	},
	489	+	{
	490	+	"id": "oxygenhub.proposals",
	491	+	"title": "Proposals and issues",
	492	+	"description": "The OxygenHub sidebar lists your repositories' proposals and issues. Open a proposal to see its changes, review it, seal your approval with your key, and land it.\n[Open OxygenHub](command:workbench.view.extension.oxygenhub)",
	493	+	"media": {
	494	+	"markdown": "walkthrough/proposals.md"
	495	+	},
	496	+	"completionEvents": [
	497	+	"onView:oxygenhub.proposals"
	498	+	]
	499	+	},
	500	+	{
	501	+	"id": "oxygenhub.propose",
	502	+	"title": "Propose your bookmark",
	503	+	"description": "From a bookmark with work on it, propose it for the default bookmark. Issues its changes close are linked, and closed when it lands.\n[Create Proposal](command:oxygenhub.createProposal)",
	504	+	"media": {
	505	+	"markdown": "walkthrough/propose.md"
	506	+	},
	507	+	"completionEvents": [
	508	+	"onCommand:oxygenhub.createProposal"
	509	+	]
	510	+	},
	511	+	{
	512	+	"id": "oxygenhub.flow",
	513	+	"title": "Watch Flow",
	514	+	"description": "Every push runs the repository's OxygenFlow pipeline in microVMs. The Flow view shows runs and jobs as they go; click a job for its log, live. Run Pipeline starts one without a push.\n[Run Pipeline](command:oxygenhub.runPipeline)",
	515	+	"media": {
	516	+	"markdown": "walkthrough/flow.md"
	517	+	},
	518	+	"completionEvents": [
	519	+	"onCommand:oxygenhub.runPipeline"
	520	+	]
	521	+	},
	522	+	{
	523	+	"id": "oxygenhub.inbox",
	524	+	"title": "Your inbox",
	525	+	"description": "Mentions, reviews asked of you and activity on what you watch.\n[Open Inbox](command:oxygenhub.inbox)",
	526	+	"media": {
	527	+	"markdown": "walkthrough/inbox.md"
	528	+	},
	529	+	"completionEvents": [
	530	+	"onCommand:oxygenhub.inbox"
	531	+	]
	532	+	}
	533	+	]
470	534		}
471	535		]
472	536		},
		…	18 unchanged lines

`/`	Search
`g` `c`	Code
`g` `h`	History
`g` `b`	Bookmarks
`g` `t`	Trust
`y`	Permalink to this state (files and trees)
`?`	This sheet

1	+	# Inbox
2	+
3	+	The envelope in the status bar counts what is new; the inbox opens on the hub's notifications.

1	+	# Proposals
2	+
3	+	A proposal asks for a bookmark's changes to land on another. Approvals count when they are sealed: one signature from your key over exactly the changes you reviewed.

1	+	# Proposing
2	+
3	+	Write `closes #N` in a change or the description to link an issue: the hub shows the chain from issue to proposal to bookmark.

1	+	# Signing in
2	+
3	+	OxygenHub is where your repositories live for others: proposals, issues, releases, Flow. Sign in once per hub; the token is kept in VS Code's secret storage.

A Get started with OxygenHub walkthrough (0.9.0) b1047516e064

Keyboard