forestui 0.9.0__py3-none-any.whl

forestui-0.9.0.dist-info/METADATA

@@ -0,0 +1,152 @@
+Metadata-Version: 2.4
+Name: forestui
+Version: 0.9.0
+Summary: A Terminal UI for managing Git worktrees
+Author: cadu
+Keywords: git,terminal,textual,tui,worktree
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.14
+Requires-Dist: click>=8.1.0
+Requires-Dist: humanize>=4.9.0
+Requires-Dist: libtmux>=0.37.0
+Requires-Dist: pydantic>=2.12.5
+Requires-Dist: textual>=7.2.0
+Description-Content-Type: text/markdown
+
+# forestui
+
+> A terminal UI for managing Git worktrees, inspired by [forest](https://github.com/ricwo/forest) for macOS by [@ricwo](https://github.com/ricwo).
+
+forestui brings the power of Git worktree management to the terminal with a beautiful TUI interface built on [Textual](https://textual.textualize.io/), featuring deep integration with [Claude Code](https://claude.ai/code).
+
+![forestui screenshot](doc/screenshot_small.png)
+
+## Features
+
+- **Repository Management**: Add and track multiple Git repositories
+- **Worktree Operations**: Create, rename, archive, and delete worktrees
+- **TUI Editor Integration**: Opens TUI editors (vim, nvim, helix, etc.) in tmux windows
+- **Claude Code Integration**: Track and resume Claude Code sessions per worktree
+- **Multi-Forest Support**: Manage multiple forest directories via CLI argument
+- **tmux Native**: Runs inside tmux for a cohesive terminal experience
+
+## Requirements
+
+- Python 3.14+
+- tmux
+- uv (for installation)
+
+## Installing
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/flipbit03/forestui/main/install.sh | bash
+```
+
+## Usage
+
+```bash
+# Start with default forest directory (~/forest)
+forestui
+
+# Start with a custom forest directory
+forestui ~/my-projects
+
+# Update to latest version
+forestui --self-update
+
+# Show help
+forestui --help
+```
+
+### Keyboard Shortcuts
+
+| Key | Action |
+|-----|--------|
+| `a` | Add repository |
+| `w` | Add worktree |
+| `e` | Open in editor |
+| `t` | Open in terminal |
+| `o` | Open in file manager |
+| `n` | Start Claude session |
+| `y` | Start Claude session (YOLO mode) |
+| `h` | Toggle archive |
+| `d` | Delete |
+| `s` | Settings |
+| `r` | Refresh |
+| `?` | Show help |
+| `q` | Quit |
+
+### TUI Editor Integration
+
+When your default editor is a TUI editor (vim, nvim, helix, nano, etc.), forestui opens it in a new tmux window named `edit:<worktree>`. This keeps your editing session organized alongside forestui and any Claude sessions.
+
+Supported TUI editors: `vim`, `nvim`, `vi`, `emacs`, `nano`, `helix`, `hx`, `micro`, `kakoune`, `kak`
+
+### Multi-Forest Support
+
+forestui stores its state (`.forestui-config.json`) in the forest directory itself, allowing you to manage multiple independent forests:
+
+```bash
+forestui ~/work      # Uses ~/work/.forestui-config.json
+forestui ~/personal  # Uses ~/personal/.forestui-config.json
+```
+
+User preferences (editor, theme, branch prefix) are stored globally in `~/.config/forestui/settings.json`.
+
+## Configuration
+
+Settings are stored in `~/.config/forestui/settings.json`:
+
+```json
+{
+  "default_editor": "nvim",
+  "branch_prefix": "feat/",
+  "theme": "system"
+}
+```
+
+Press `s` in the app to open the settings modal.
+
+## Development
+
+```bash
+# Clone and enter the repo
+git clone https://github.com/flipbit03/forestui.git
+cd forestui
+
+# Install dev dependencies
+make dev
+
+# Run checks
+make check
+
+# Format code
+make format
+
+# Run the app
+make run
+```
+
+See [CLAUDE.md](CLAUDE.md) for AI-assisted development guidelines.
+
+## Compatibility with forest (macOS)
+
+forestui is designed to coexist with [forest](https://github.com/ricwo/forest) for macOS:
+
+- Both apps can share the same `~/forest` directory for worktrees
+- Each app maintains its own state file:
+  - forest: `.forest-config.json` (stored in `~/.config/forest/`)
+  - forestui: `.forestui-config.json` (stored in the forest folder itself)
+- Worktrees created by either app work seamlessly with both
+
+**Key difference:** forestui stores its state inside the forest folder (`~/forest/.forestui-config.json`) rather than in a global config directory. This design enables multi-forest support - you can run `forestui ~/work` and `forestui ~/personal` with completely independent state for each.
+
+## License
+
+MIT

forestui-0.9.0.dist-info/RECORD

@@ -0,0 +1,23 @@
+forestui/__init__.py,sha256=5XV7YExNshXcR27WcUWlQNu3eBmtNFt_IikkFCwhLb4,82
+forestui/__main__.py,sha256=nDdStXHt-5rnJh-nihdYReIx0MlTOvtNVwu4HhNbPNM,102
+forestui/app.py,sha256=Yt4C6cHAao0Y4WRia6-pBCMvT3AXh5BZMoNCjSAZ6-Q,39779
+forestui/cli.py,sha256=j0tUXDK58_tPqgwTPaHsB496KlDsnNdOcC0pU5Xq6Uo,4802
+forestui/models.py,sha256=vSeGOis6kdxJDV7720U-X0tACTJQkDnMY9WXYUAJsuA,6167
+forestui/state.py,sha256=x54bDbYZYuQa8Yv00v6AzUBiDKeP1N55sNEPcRQh6tM,8854
+forestui/theme.py,sha256=EaK-nX5H6qU34SEauS2EfDAYjk_QtgTEyf6cw1Yhl2E,9199
+forestui/components/__init__.py,sha256=di1gcQvhn_g1PasCZM_Wddl5pDOSJ51PvLI8SGfV1hY,518
+forestui/components/messages.py,sha256=aXivaa5oY3Cp5pWduuBfZWe-Ff6wjaWY_KUEJV4CcGs,1860
+forestui/components/modals.py,sha256=-f6w1farHIy5vPEKImwp3SSRITnp5GxOZFNEYUchH1A,23494
+forestui/components/repository_detail.py,sha256=4tORX6U_MuBj-tsv1FK1C-K5gvAAKbHalErcg5ad6HI,14819
+forestui/components/sidebar.py,sha256=OwjC3pyKPqPe3_DTMk2H7QOV-hKJdyr-8N35N2twI18,8899
+forestui/components/worktree_detail.py,sha256=edcC-R43ZsVIFc2VPxtWwVJr4cCaCXVMfpg0rMEwSiQ,12473
+forestui/services/__init__.py,sha256=gNs1XGnyy277xOQNV-rc5tVejRZyjJRcWQ8h3WdPc4k,464
+forestui/services/claude_session.py,sha256=jUM6ng39cUlWIfyvoglsYaqAMmT6NEfiROehIMd3kXg,6618
+forestui/services/git.py,sha256=9Gu_yawmAckhBkepkNID80I_r4bFMqqs9IbTjT6VY4Q,9165
+forestui/services/github.py,sha256=jZF0iYDL4iZHarXC5zYfqLhuyUDiP_VsUwP63Z7cSt8,8156
+forestui/services/settings.py,sha256=j7PgYMoCaTv4moakNU2Uo75gMvezyYsmPpBV71-4Uec,2608
+forestui/services/tmux.py,sha256=WPTm0JUV9wGbXo70iwW1l3gcjqlZUnwWO_W7whtC_Jg,9715
+forestui-0.9.0.dist-info/METADATA,sha256=CMa6ghedA9sxFDtJNaZmlQMjgBxLATl1ch1mR59bN44,4434
+forestui-0.9.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+forestui-0.9.0.dist-info/entry_points.txt,sha256=ifci7XODOi-Wmgal3AP-wCbNmsU7a2sHI-xe-def8CM,47
+forestui-0.9.0.dist-info/RECORD,,

forestui-0.9.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

forestui-0.9.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+forestui = forestui.app:main