chore(release): version packages#890
Merged
Merged
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub. 1 Skipped Deployment
|
Contributor
📄 Knowledge review✏️ Documentation updates2 pages were updated by changes in this PR.
📝 02 - Workspace — changes@@ -1,15 +1,31 @@
# 02 - Workspace
-A workspace is the central unit of work in Helmor. It represents an isolated working copy — a branch, a file tree, and a set of sessions — dedicated to a single task.
+A workspace is the central unit of work in Helmor. It represents an isolated working copy — a file tree and a set of sessions — dedicated to a single task.
+
+## Workspace types
+
+Helmor supports two types of workspaces:
+
+- **Git-based workspaces** (default) — the workspace is attached to a Git repository. These workspaces provide branch isolation, diff baselines, branch pickers, and Git-specific features.
+- **Non-git workspaces** — the workspace is attached to a plain local folder without Git. These use a chat-style layout with no diff/inspector panels or branch pickers, and run as local-mode sessions with no branch or worktree actions.
## What a workspace provides
+
+For Git-based workspaces:
- **Branch isolation** — each workspace gets its own Git branch so agent edits never contaminate other work.
- **File tree** — browse, search, and edit files scoped to this workspace's state.
- **Session history** — every agent conversation and its resulting changes are recorded.
- **Diff baseline** — changes are compared against the workspace's target branch.
+For non-git workspaces:
+
+- **File tree** — browse, search, and edit files in the local folder.
+- **Session history** — every agent conversation and its resulting changes are recorded.
+
## Isolation modes
+
+Git-based workspaces support three isolation modes:
| Mode | How it works |
|------|-------------|
@@ -17,19 +33,27 @@
| **Local** | Points directly at the repository root. Multiple conversations share the same files. Useful for quick edits without branching overhead. |
| **Chat** | A scratch directory with no Git binding. Good for exploratory questions where you don't need file changes. |
+Non-git workspaces always operate in local mode — they point directly at the folder you opened.
+
## Lifecycle
-Workspaces move through four states:
+Git-based workspaces move through four states:
1. **Initializing** — database record created; filesystem setup in progress.
2. **SetupPending** — a project setup script was detected (e.g., dependency install). Run it or skip.
3. **Ready** — the workspace is usable. Start sessions, browse files, review diffs.
4. **Archived** — task complete. The worktree is cleaned up and the branch deleted (if Helmor created it).
+Non-git workspaces have a simplified lifecycle without branch or worktree cleanup.
+
## Branching behavior
+
+For Git-based workspaces:
- **FromBranch** — Helmor forks a new branch from your selection. The workspace owns the branch; archiving deletes it.
- **UseBranch** — the workspace attaches to an existing branch. The branch is preserved on archive.
+
+Non-git workspaces have no branching behavior.
## Best practices
📝 03 - Add a Repository — changes@@ -5,10 +5,18 @@
## Add a local repository
1. Open Helmor and click **Add Repository** (or use the `+` button in the sidebar).
-2. Browse to your local Git project folder.
-3. Confirm the detected default branch (e.g., `main` or `master`).
+2. Browse to a local folder (Git or non-git).
+3. If the folder is a Git repository, confirm the detected default branch (e.g., `main` or `master`).
The repository appears in your sidebar immediately. Helmor reads the Git history, branches, and file tree from disk.
+
+### Non-git folders
+
+Non-git folders work out of the box with no additional settings. When you add a non-git directory:
+
+- Workspaces run in a chat-style layout without the diff/inspector panel or branch pickers.
+- Sessions operate in local mode with no branch or worktree actions.
+- The repository settings page displays a "Non-git repository" notice instead of account and Git options.
## Add a GitHub repository
@@ -18,12 +26,14 @@
## What Helmor reads
-Helmor uses the repository as the source for:
+For **Git repositories**, Helmor uses the repository as the source for:
- **Workspaces** — isolated copies branched from your default or target branch.
- **File browsing** — view, search, and navigate the project tree.
- **Diffs** — compare agent changes against the base branch.
- **Git operations** — commit, push, and prepare PRs from inside the app.
+
+For **non-git folders**, Helmor provides file browsing and chat-based agent sessions without Git-specific features.
Helmor does not replace Git. It wraps Git with an agent-friendly workflow layer.
|
17aa643 to
4eb6628
Compare
4eb6628 to
b1592b6
Compare
b1592b6 to
336732f
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This PR was opened by the Changesets release GitHub action. When you're ready to do a release, you can merge this and the packages will be published to npm automatically. If you're not ready to do a release yet, that's fine, whenever you add more changesets to main, this PR will be updated.
Releases
helmor@0.43.0
Minor Changes
#825
4d07a72Thanks @JRBusiness! - Add opt-in support for attaching sessions to plain local folders that are not git repositories.Patch Changes
#894
e0beec2Thanks @dohooo! - Scrolling up in a chat thread and stopping no longer makes the conversation jump or shake — row heights now settle into place while the scroll is still moving, so your reading position stays put.#895
d176c6dThanks @dohooo! - Fix in-review workspaces sometimes opening to an empty "No session selected" panel instead of their conversation.#893
c56bb1bThanks @natllian! - Refine non-git directory workspace support: