| Name | gemini-wt JSON |
| Version |
0.0.1
JSON |
| download |
| home_page | None |
| Summary | Manage parallel Gemini CLI instances |
| upload_time | 2025-07-16 08:20:55 |
| maintainer | None |
| docs_url | None |
| author | Daniel Ratmiroff |
| requires_python | >=3.12 |
| license | None |
| keywords |
ai
gemini
git
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# 🔷 Gemini-Worktree
Run multiple Gemini Code instances in parallel without stepping on each other. This CLI creates isolated git worktrees for each Gemini session, so you can work on different features simultaneously while keeping your main branch clean.
_Inspired and forked from a utility by [Jeremiah Lowin](https://github.com/jlowin/claude-wt)._
## 🚀 Quick Start
Jump right in without installing anything:
```bash
uvx gemini-wt new "implement user authentication"
```
**That's it.** You're now working in a clean branch where Gemini can't mess up your pristine codebase.
### Installation Options
If you prefer global installation:
```bash
uv tool install gemini-wt
```
## 🎯 Commands
### ✨ Start Fresh: `new`
Spin up a new isolated Gemini session:
```bash
uvx gemini-wt new "implement user authentication"
```
Behind the scenes: creates a timestamp branch, sets up a worktree in `.gemini/worktrees/`, and launches Gemini with your query.
Want a memorable branch name? Use `--name`:
```bash
uvx gemini-wt new "fix the parser" --name parser-fix
```
Need to branch from a specific source? Use `--branch`:
```bash
uvx gemini-wt new "hotfix for prod" --branch main --name hotfix-123
```
### 🔄 Pick Up Where You Left Off: `resume`
Gemini sessions are like good TV shows—you want to continue watching:
```bash
uvx gemini-wt resume 20241201-143022
```
The session ID is shown when you create it.
### 📋 See What's Running: `list`
See all your active worktrees:
```bash
uvx gemini-wt list
```
Shows each session with its health status.
### 🧹 Clean Up: `clean`
Remove a specific session when you're done:
```bash
uvx gemini-wt clean 20241201-143022
```
Or clean everything:
```bash
uvx gemini-wt clean --all # The Marie Kondo approach
```
## 🔧 How It Works
Think of it like having multiple parallel universes for your code:
1. **Branch Creation** → Each session gets its own branch (`gemini-{timestamp}` or your custom name)
2. **Worktree Setup** → Creates a separate directory in `.gemini/worktrees/` so files don't conflict
3. **Gemini Launch** → Starts Gemini in the isolated environment with full repo access
4. **Session Management** → Resume, list, and clean up sessions effortlessly
## 🎁 Why You'll Love This
- **Fear-Free Experimentation** → Gemini can't break your main branch even if it tries
- **Mental Clarity** → No more "did I commit that test code?" anxiety
- **Context Switching** → Jump between different Gemini conversations effortlessly
- **Easy Cleanup** → One command to remove all experimental branches
- **Clean History** → Your main branch stays pristine for serious work
## 📋 What You Need
- **Python 3.12+**
- **Git with worktree support** (any recent version)
- **Gemini CLI** (installed and authenticated)
## 🛠️ Development
Uses uv for dependency management:
```bash
uv sync
uv run gemini-wt --help
```
Or test changes without installing:
```bash
uvx --from . gemini-wt --help
```
Raw data
{
"_id": null,
"home_page": null,
"name": "gemini-wt",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.12",
"maintainer_email": null,
"keywords": "ai, gemini, git",
"author": "Daniel Ratmiroff",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/09/88/a368ee78256df0f2b1867937af8b41cf4d2a0cdfe852258b9c572b4c7f10/gemini_wt-0.0.1.tar.gz",
"platform": null,
"description": "# \ud83d\udd37 Gemini-Worktree\n\nRun multiple Gemini Code instances in parallel without stepping on each other. This CLI creates isolated git worktrees for each Gemini session, so you can work on different features simultaneously while keeping your main branch clean.\n\n_Inspired and forked from a utility by [Jeremiah Lowin](https://github.com/jlowin/claude-wt)._\n\n## \ud83d\ude80 Quick Start\n\nJump right in without installing anything:\n\n```bash\nuvx gemini-wt new \"implement user authentication\"\n```\n\n**That's it.** You're now working in a clean branch where Gemini can't mess up your pristine codebase.\n\n### Installation Options\n\nIf you prefer global installation:\n\n```bash\nuv tool install gemini-wt\n```\n\n## \ud83c\udfaf Commands\n\n### \u2728 Start Fresh: `new`\n\nSpin up a new isolated Gemini session:\n\n```bash\nuvx gemini-wt new \"implement user authentication\"\n```\n\nBehind the scenes: creates a timestamp branch, sets up a worktree in `.gemini/worktrees/`, and launches Gemini with your query.\n\nWant a memorable branch name? Use `--name`:\n\n```bash\nuvx gemini-wt new \"fix the parser\" --name parser-fix\n```\n\nNeed to branch from a specific source? Use `--branch`:\n\n```bash\nuvx gemini-wt new \"hotfix for prod\" --branch main --name hotfix-123\n```\n\n### \ud83d\udd04 Pick Up Where You Left Off: `resume`\n\nGemini sessions are like good TV shows\u2014you want to continue watching:\n\n```bash\nuvx gemini-wt resume 20241201-143022\n```\n\nThe session ID is shown when you create it.\n\n### \ud83d\udccb See What's Running: `list`\n\nSee all your active worktrees:\n\n```bash\nuvx gemini-wt list\n```\n\nShows each session with its health status.\n\n### \ud83e\uddf9 Clean Up: `clean`\n\nRemove a specific session when you're done:\n\n```bash\nuvx gemini-wt clean 20241201-143022\n```\n\nOr clean everything:\n\n```bash\nuvx gemini-wt clean --all # The Marie Kondo approach\n```\n\n## \ud83d\udd27 How It Works\n\nThink of it like having multiple parallel universes for your code:\n\n1. **Branch Creation** \u2192 Each session gets its own branch (`gemini-{timestamp}` or your custom name)\n2. **Worktree Setup** \u2192 Creates a separate directory in `.gemini/worktrees/` so files don't conflict\n3. **Gemini Launch** \u2192 Starts Gemini in the isolated environment with full repo access\n4. **Session Management** \u2192 Resume, list, and clean up sessions effortlessly\n\n## \ud83c\udf81 Why You'll Love This\n\n- **Fear-Free Experimentation** \u2192 Gemini can't break your main branch even if it tries\n- **Mental Clarity** \u2192 No more \"did I commit that test code?\" anxiety\n- **Context Switching** \u2192 Jump between different Gemini conversations effortlessly\n- **Easy Cleanup** \u2192 One command to remove all experimental branches\n- **Clean History** \u2192 Your main branch stays pristine for serious work\n\n## \ud83d\udccb What You Need\n\n- **Python 3.12+**\n- **Git with worktree support** (any recent version)\n- **Gemini CLI** (installed and authenticated)\n\n## \ud83d\udee0\ufe0f Development\n\nUses uv for dependency management:\n\n```bash\nuv sync\nuv run gemini-wt --help\n```\n\nOr test changes without installing:\n\n```bash\nuvx --from . gemini-wt --help\n```\n",
"bugtrack_url": null,
"license": null,
"summary": "Manage parallel Gemini CLI instances",
"version": "0.0.1",
"project_urls": {
"Homepage": "https://github.com/Danielratmiroff/gemini-wt"
},
"split_keywords": [
"ai",
" gemini",
" git"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "752caa0799e6dc6c14cfd63d7f928d0faee4e8e99e2cd789e956e49b8b79c698",
"md5": "62c0d90e1f0e74c9f8adc01c5b144f5a",
"sha256": "fcc133444756c0f0c778c172ebffbbd4ee0f398c00ab17122e0f2d285ec06ab9"
},
"downloads": -1,
"filename": "gemini_wt-0.0.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "62c0d90e1f0e74c9f8adc01c5b144f5a",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.12",
"size": 6515,
"upload_time": "2025-07-16T08:20:55",
"upload_time_iso_8601": "2025-07-16T08:20:55.030670Z",
"url": "https://files.pythonhosted.org/packages/75/2c/aa0799e6dc6c14cfd63d7f928d0faee4e8e99e2cd789e956e49b8b79c698/gemini_wt-0.0.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "0988a368ee78256df0f2b1867937af8b41cf4d2a0cdfe852258b9c572b4c7f10",
"md5": "71f5881090297c9a588620df76ecd09e",
"sha256": "ece92de9d5476191832f22a74fecdd16ce2ced7f8a7331f765fc58f1de3917d3"
},
"downloads": -1,
"filename": "gemini_wt-0.0.1.tar.gz",
"has_sig": false,
"md5_digest": "71f5881090297c9a588620df76ecd09e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.12",
"size": 15595,
"upload_time": "2025-07-16T08:20:55",
"upload_time_iso_8601": "2025-07-16T08:20:55.724389Z",
"url": "https://files.pythonhosted.org/packages/09/88/a368ee78256df0f2b1867937af8b41cf4d2a0cdfe852258b9c572b4c7f10/gemini_wt-0.0.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-16 08:20:55",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Danielratmiroff",
"github_project": "gemini-wt",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "gemini-wt"
}
