forestui 0.9.0__tar.gz → 0.9.2__tar.gz

{forestui-0.9.0 → forestui-0.9.2}/CLAUDE.md

@@ -160,31 +160,23 @@ Currently no test suite. When adding tests:
 
 ## Versioning
 
-Version is defined in **both** `forestui/__init__.py` and `pyproject.toml`:
-```python
-__version__ = "0.1.0"
-```
-
-**IMPORTANT:** The `main` branch represents the release. Every feature, fix, or change merged to `main` **must** include a version bump in both files:
-- **Patch** (0.0.X): Bug fixes, dead code removal, minor cleanup
-- **Minor** (0.X.0): New features, enhancements
-- **Major** (X.0.0): Breaking changes
+Version is `0.0.0` in source code. Actual versions are derived from git tags at release time.
 
-This is required for `--self-update` to work correctly - it compares the local version against the remote to detect updates. If you forget to bump the version, users won't see the update.
+### Development
 
-### Workflow: Test Before Commit
+1. Create a branch, make changes
+2. Run `make check` and test locally
+3. Open a PR and merge to `main`
 
-**Do NOT bump the version, commit, or push until the user has tested and approved the changes.**
+Running from source (`uv run forestui`) shows version `0.0.0` and auto-enables dev mode.
 
-Every commit to `main` with a bumped version is an actual release that will propagate to all users via `--self-update`. The workflow should be:
+### Releasing
 
-1. Make code changes
-2. Run `make check` to verify lint/typecheck pass (do this BEFORE bumping version - if linter reformats code, you don't want to bump twice)
-3. **Ask the user to test the changes** before proceeding
-4. Bump version in both `forestui/__init__.py` and `pyproject.toml`
-5. Commit and push
+```bash
+gh release create v0.9.1 --generate-notes
+```
 
-This keeps a human in the loop for quality control before releasing.
+This triggers the publish workflow which builds and publishes to PyPI.
 
 ## Git Commits
 

{forestui-0.9.0 → forestui-0.9.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: forestui
-Version: 0.9.0
+Version: 0.9.2
 Summary: A Terminal UI for managing Git worktrees
 Author: cadu
 Keywords: git,terminal,textual,tui,worktree
@@ -41,13 +41,34 @@ forestui brings the power of Git worktree management to the terminal with a beau
 - Python 3.14+
 - tmux
 - uv (for installation)
+- [gh](https://cli.github.com/) (optional, for GitHub integration)
 
 ## Installing
 
+### Quick Install (recommended)
+
+Installs [uv](https://github.com/astral-sh/uv) automatically if not present. No Python installation required.
+
 ```bash
 curl -fsSL https://raw.githubusercontent.com/flipbit03/forestui/main/install.sh | bash
 ```
 
+### Install via uv
+
+If you already have [uv](https://github.com/astral-sh/uv) installed:
+
+```bash
+uv tool install forestui
+```
+
+### Updating
+
+forestui auto-updates on startup. To manually update:
+
+```bash
+uv tool upgrade forestui
+```
+
 ## Usage
 
 ```bash
@@ -57,9 +78,6 @@ forestui
 # Start with a custom forest directory
 forestui ~/my-projects
 
-# Update to latest version
-forestui --self-update
-
 # Show help
 forestui --help
 ```

{forestui-0.9.0 → forestui-0.9.2}/README.md

@@ -20,13 +20,34 @@ forestui brings the power of Git worktree management to the terminal with a beau
 - Python 3.14+
 - tmux
 - uv (for installation)
+- [gh](https://cli.github.com/) (optional, for GitHub integration)
 
 ## Installing
 
+### Quick Install (recommended)
+
+Installs [uv](https://github.com/astral-sh/uv) automatically if not present. No Python installation required.
+
 ```bash
 curl -fsSL https://raw.githubusercontent.com/flipbit03/forestui/main/install.sh | bash
 ```
 
+### Install via uv
+
+If you already have [uv](https://github.com/astral-sh/uv) installed:
+
+```bash
+uv tool install forestui
+```
+
+### Updating
+
+forestui auto-updates on startup. To manually update:
+
+```bash
+uv tool upgrade forestui
+```
+
 ## Usage
 
 ```bash
@@ -36,9 +57,6 @@ forestui
 # Start with a custom forest directory
 forestui ~/my-projects
 
-# Update to latest version
-forestui --self-update
-
 # Show help
 forestui --help
 ```

forestui-0.9.2/forestui/__init__.py

@@ -0,0 +1,9 @@
+"""forestui - A Terminal UI for managing Git worktrees."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("forestui")
+except PackageNotFoundError:
+    # Package not installed (running from source without install)
+    __version__ = "0.0.0"

{forestui-0.9.0 → forestui-0.9.2}/forestui/cli.py

@@ -147,6 +147,9 @@ def main(
 
     FOREST_PATH: Optional path to forest directory (default: ~/forest)
     """
+    # Auto-enable dev mode when running from source (version 0.0.0)
+    dev_mode = dev_mode or __version__ == "0.0.0"
+
     ensure_tmux(forest_path, debug_mode, no_self_update, dev_mode)
 
     if debug_mode:

{forestui-0.9.0 → forestui-0.9.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "forestui"
-version = "0.9.0"
+version = "0.9.2"
 description = "A Terminal UI for managing Git worktrees"
 readme = "README.md"
 requires-python = ">=3.14"

{forestui-0.9.0 → forestui-0.9.2}/uv.lock

@@ -155,7 +155,7 @@ wheels = [
 
 [[package]]
 name = "forestui"
-version = "0.9.0"
+version = "0.0.0"
 source = { editable = "." }
 dependencies = [
     { name = "click" },

forestui-0.9.0/forestui/__init__.py

@@ -1,3 +0,0 @@
-"""forestui - A Terminal UI for managing Git worktrees."""
-
-__version__ = "0.9.0"