git-workspace-tui 0.1.0__tar.gz

git_workspace_tui-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,25 @@
+name: CI
+
+on:
+  push:
+  pull_request:
+
+jobs:
+  test:
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest]
+        python-version: ["3.11", "3.12"]
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+      - run: uv sync --dev
+      - run: uv run ruff check .
+      - run: uv run pytest
+      - run: uv run python -m build
+

git_workspace_tui-0.1.0/.github/workflows/publish.yml

@@ -0,0 +1,29 @@
+name: Publish
+
+on:
+  push:
+    tags:
+      - "v*"
+
+permissions:
+  contents: read
+
+jobs:
+  publish:
+    name: Publish to PyPI
+    runs-on: ubuntu-latest
+    environment: pypi
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: astral-sh/setup-uv@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - run: uv sync --dev
+      - run: uv run ruff check .
+      - run: uv run pytest
+      - run: uv run python -m build
+      - uses: pypa/gh-action-pypi-publish@release/v1

git_workspace_tui-0.1.0/.gitignore

@@ -0,0 +1,10 @@
+.DS_Store
+.pytest_cache/
+.ruff_cache/
+.venv/
+__pycache__/
+*.egg-info/
+build/
+dist/
+workspace.local.yml
+

git_workspace_tui-0.1.0/CHANGELOG.md

@@ -0,0 +1,9 @@
+# Changelog
+
+## 0.1.0
+
+- Initial Git-aware multi-repo terminal implementation.
+- Adds `gws` and `g` command entry points.
+- Adds shell-first TUI execution with optional Git shortcut mode.
+- Adds workspace configuration, status, plan, switch, pull, sync, and exec commands.
+

git_workspace_tui-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,23 @@
+# Contributing
+
+Thanks for helping improve Git Workspace.
+
+## Development Setup
+
+```bash
+uv sync --dev
+uv run pytest
+uv run ruff check .
+```
+
+## Pull Requests
+
+- Keep behavior changes covered by tests.
+- Preserve the shell-first execution model unless the change explicitly targets Git mode.
+- Avoid adding dependencies unless they materially improve reliability or portability.
+- Do not rely on a specific user's shell configuration in tests.
+
+## TUI Changes
+
+For TUI changes, add or update headless Textual tests where possible. Important interactions include input focus, repository switching, command cancellation, and mode switching.
+

git_workspace_tui-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 liusheng22
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

git_workspace_tui-0.1.0/PKG-INFO

@@ -0,0 +1,265 @@
+Metadata-Version: 2.4
+Name: git-workspace-tui
+Version: 0.1.0
+Summary: Git-aware multi-repo terminal workspace
+Project-URL: Homepage, https://github.com/liusheng22/git-workspace
+Project-URL: Repository, https://github.com/liusheng22/git-workspace
+Project-URL: Issues, https://github.com/liusheng22/git-workspace/issues
+Author: liusheng22
+License-Expression: MIT
+License-File: LICENSE
+Keywords: git,multi-repo,terminal,tui,workspace
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Version Control :: Git
+Requires-Python: >=3.11
+Requires-Dist: pyyaml>=6.0.2
+Requires-Dist: rich>=13.7
+Requires-Dist: textual>=0.86
+Description-Content-Type: text/markdown
+
+# Git Workspace
+
+[中文文档](README.zh-CN.md)
+
+Git Workspace (`gws`) is a Git-aware multi-repo terminal. It is built for one common developer setup: a single directory that contains many Git repositories.
+
+![Why Git Workspace exists](docs/workspace-problem.svg)
+
+## 60-Second Start
+
+Install from PyPI:
+
+```bash
+uv tool install git-workspace-tui
+```
+
+Open the directory that contains your repos:
+
+```bash
+cd ~/Projects/workspace
+gws
+```
+
+Inside the TUI, the first row is `ALL REPOS`. Type once there to run in every repo:
+
+```text
+ALL shell > git status -sb
+```
+
+Press `Tab` to move to one repo and run a focused command:
+
+```text
+api@main shell > pnpm test
+```
+
+## TUI Map
+
+![TUI guide](docs/tui-preview.svg)
+
+The TUI has only two concepts:
+
+| Area | Meaning |
+| --- | --- |
+| Left panel | Choose the target: `ALL REPOS` or one repository. |
+| Right panel | Continuous command log and one command input. |
+
+Useful keys:
+
+| Key | Action |
+| --- | --- |
+| `Tab` / `Shift+Tab` | Move through `ALL REPOS` and repository rows. |
+| `Enter` | Run the input in the selected target. |
+| `Up` / `Down` | Command history. |
+| `Ctrl+C` | Cancel running command, or quit when idle. |
+| `Ctrl+Q` | Quit. |
+| `:git` / `:shell` | Switch execution mode. |
+| `:clear` / `:refresh` | Clear log / refresh repos. |
+
+## ALL REPOS vs One Repo
+
+![Target model](docs/target-model.svg)
+
+`ALL REPOS` is a real operating target, not a hidden mode.
+
+```text
+ALL shell > git status -sb
+ALL shell > git pull --ff-only
+ALL shell > git push
+```
+
+Repository rows are for focused work:
+
+```text
+api@main shell > pnpm test
+api@main shell > git checkout dev
+api@dev shell > git pull --ff-only
+```
+
+## Command Flow
+
+![Command flow](docs/command-flow.svg)
+
+Default mode is `shell`, so Git Workspace runs commands through your configured shell in the target repo directory.
+
+```text
+ALL shell > git status -sb
+web@dev shell > npm run build
+```
+
+Use Git mode when you want shorter Git subcommands and Git aliases:
+
+```text
+:git
+ALL git > status -sb
+api@main git > gco dev
+:shell
+```
+
+Shell aliases and functions are loaded best-effort. Portable team shortcuts should go in `workspace.yml` or Git's own `alias.*` config.
+
+## CLI Safety Flow
+
+![CLI safety flow](docs/cli-safety.svg)
+
+The TUI `ALL REPOS` target is terminal-like: it runs the command you type in every repo.
+
+For safer branch / pull workflows, use the plan-aware CLI commands:
+
+```bash
+gws status
+gws plan daily
+gws switch daily
+gws pull daily
+gws sync daily
+```
+
+Command meanings:
+
+| Command | Purpose |
+| --- | --- |
+| `status` | Show branch, target, dirty state, upstream, ahead / behind. |
+| `plan` | Explain actions before changing anything. |
+| `switch` | Checkout target branches when safe. |
+| `pull` | Pull clean repos already on target branch. |
+| `sync` | Switch to target branches, then pull safe repos. |
+| `exec` | Run a shell command across repos. |
+
+Run any command across repos from the CLI:
+
+```bash
+gws exec -- pwd
+gws exec -- git status -sb
+gws exec daily -- pnpm test
+```
+
+## Configuration Model
+
+![Configuration model](docs/config-model.svg)
+
+Git Workspace works without a config by discovering Git repositories directly under the current directory. Add `workspace.yml` when you want shared defaults.
+
+```yaml
+workspace:
+  root: .
+  ignore:
+    - node_modules
+    - .cache
+    - dist
+
+repos:
+  api:
+    path: ./api
+    default: main
+  web:
+    path: ./web
+    default: dev
+
+profiles:
+  daily:
+    api: main
+    web: dev
+    "*": main
+
+aliases:
+  gco: checkout
+  gcb: checkout -b
+  gl: pull
+  gp: push
+
+exec:
+  defaultMode: shell
+  gitShortcuts: true
+  shell:
+    interactive: true
+```
+
+Use `workspace.local.yml` for machine-specific overrides. It should usually stay uncommitted.
+
+## Install Options
+
+With `uv`:
+
+```bash
+uv tool install git-workspace-tui
+```
+
+With `pipx`:
+
+```bash
+pipx install git-workspace-tui
+```
+
+Install a fixed version from GitHub:
+
+```bash
+uv tool install git+https://github.com/liusheng22/git-workspace.git@v0.1.0
+```
+
+From a local clone:
+
+```bash
+git clone https://github.com/liusheng22/git-workspace.git
+cd git-workspace
+uv sync --dev
+uv run gws --help
+```
+
+`g` is also installed as a short alias for `gws`:
+
+```bash
+g
+g status
+g plan
+```
+
+## Safety Notes
+
+- `ALL REPOS` runs your command in every repo. It intentionally behaves like a multi-repo terminal.
+- `plan`, `pull`, and `sync` inspect branch and dirty state before changing repositories.
+- Dirty worktrees are not auto-fixed.
+- Unsafe branch switching is skipped.
+
+When in doubt:
+
+```bash
+gws status
+gws plan
+```
+
+## Development
+
+```bash
+uv sync --dev
+uv run pytest
+uv run ruff check .
+uv run python -m build
+```
+
+Git Workspace currently targets macOS and Linux.

git_workspace_tui-0.1.0/README.md

@@ -0,0 +1,239 @@
+# Git Workspace
+
+[中文文档](README.zh-CN.md)
+
+Git Workspace (`gws`) is a Git-aware multi-repo terminal. It is built for one common developer setup: a single directory that contains many Git repositories.
+
+![Why Git Workspace exists](docs/workspace-problem.svg)
+
+## 60-Second Start
+
+Install from PyPI:
+
+```bash
+uv tool install git-workspace-tui
+```
+
+Open the directory that contains your repos:
+
+```bash
+cd ~/Projects/workspace
+gws
+```
+
+Inside the TUI, the first row is `ALL REPOS`. Type once there to run in every repo:
+
+```text
+ALL shell > git status -sb
+```
+
+Press `Tab` to move to one repo and run a focused command:
+
+```text
+api@main shell > pnpm test
+```
+
+## TUI Map
+
+![TUI guide](docs/tui-preview.svg)
+
+The TUI has only two concepts:
+
+| Area | Meaning |
+| --- | --- |
+| Left panel | Choose the target: `ALL REPOS` or one repository. |
+| Right panel | Continuous command log and one command input. |
+
+Useful keys:
+
+| Key | Action |
+| --- | --- |
+| `Tab` / `Shift+Tab` | Move through `ALL REPOS` and repository rows. |
+| `Enter` | Run the input in the selected target. |
+| `Up` / `Down` | Command history. |
+| `Ctrl+C` | Cancel running command, or quit when idle. |
+| `Ctrl+Q` | Quit. |
+| `:git` / `:shell` | Switch execution mode. |
+| `:clear` / `:refresh` | Clear log / refresh repos. |
+
+## ALL REPOS vs One Repo
+
+![Target model](docs/target-model.svg)
+
+`ALL REPOS` is a real operating target, not a hidden mode.
+
+```text
+ALL shell > git status -sb
+ALL shell > git pull --ff-only
+ALL shell > git push
+```
+
+Repository rows are for focused work:
+
+```text
+api@main shell > pnpm test
+api@main shell > git checkout dev
+api@dev shell > git pull --ff-only
+```
+
+## Command Flow
+
+![Command flow](docs/command-flow.svg)
+
+Default mode is `shell`, so Git Workspace runs commands through your configured shell in the target repo directory.
+
+```text
+ALL shell > git status -sb
+web@dev shell > npm run build
+```
+
+Use Git mode when you want shorter Git subcommands and Git aliases:
+
+```text
+:git
+ALL git > status -sb
+api@main git > gco dev
+:shell
+```
+
+Shell aliases and functions are loaded best-effort. Portable team shortcuts should go in `workspace.yml` or Git's own `alias.*` config.
+
+## CLI Safety Flow
+
+![CLI safety flow](docs/cli-safety.svg)
+
+The TUI `ALL REPOS` target is terminal-like: it runs the command you type in every repo.
+
+For safer branch / pull workflows, use the plan-aware CLI commands:
+
+```bash
+gws status
+gws plan daily
+gws switch daily
+gws pull daily
+gws sync daily
+```
+
+Command meanings:
+
+| Command | Purpose |
+| --- | --- |
+| `status` | Show branch, target, dirty state, upstream, ahead / behind. |
+| `plan` | Explain actions before changing anything. |
+| `switch` | Checkout target branches when safe. |
+| `pull` | Pull clean repos already on target branch. |
+| `sync` | Switch to target branches, then pull safe repos. |
+| `exec` | Run a shell command across repos. |
+
+Run any command across repos from the CLI:
+
+```bash
+gws exec -- pwd
+gws exec -- git status -sb
+gws exec daily -- pnpm test
+```
+
+## Configuration Model
+
+![Configuration model](docs/config-model.svg)
+
+Git Workspace works without a config by discovering Git repositories directly under the current directory. Add `workspace.yml` when you want shared defaults.
+
+```yaml
+workspace:
+  root: .
+  ignore:
+    - node_modules
+    - .cache
+    - dist
+
+repos:
+  api:
+    path: ./api
+    default: main
+  web:
+    path: ./web
+    default: dev
+
+profiles:
+  daily:
+    api: main
+    web: dev
+    "*": main
+
+aliases:
+  gco: checkout
+  gcb: checkout -b
+  gl: pull
+  gp: push
+
+exec:
+  defaultMode: shell
+  gitShortcuts: true
+  shell:
+    interactive: true
+```
+
+Use `workspace.local.yml` for machine-specific overrides. It should usually stay uncommitted.
+
+## Install Options
+
+With `uv`:
+
+```bash
+uv tool install git-workspace-tui
+```
+
+With `pipx`:
+
+```bash
+pipx install git-workspace-tui
+```
+
+Install a fixed version from GitHub:
+
+```bash
+uv tool install git+https://github.com/liusheng22/git-workspace.git@v0.1.0
+```
+
+From a local clone:
+
+```bash
+git clone https://github.com/liusheng22/git-workspace.git
+cd git-workspace
+uv sync --dev
+uv run gws --help
+```
+
+`g` is also installed as a short alias for `gws`:
+
+```bash
+g
+g status
+g plan
+```
+
+## Safety Notes
+
+- `ALL REPOS` runs your command in every repo. It intentionally behaves like a multi-repo terminal.
+- `plan`, `pull`, and `sync` inspect branch and dirty state before changing repositories.
+- Dirty worktrees are not auto-fixed.
+- Unsafe branch switching is skipped.
+
+When in doubt:
+
+```bash
+gws status
+gws plan
+```
+
+## Development
+
+```bash
+uv sync --dev
+uv run pytest
+uv run ruff check .
+uv run python -m build
+```
+
+Git Workspace currently targets macOS and Linux.