gw - GitLite

KO | EN

gitlite — search

#javascript #hacktoberfest #llm #nodejs #java #windows #awesome #kubernetes #vue #awesome-list #security #mcp #openai #open-source

gw

(★ 100)

No description available.

파일 탐색기

최종 버전 다운로드 (.zip)

- - release.yml
- - exec.rs
  - mod.rs
- cli.rs
- config.rs
- git.rs
- main.rs
- meta.rs
.gitignore
AGENTS.md
Cargo.lock
Cargo.toml
install.sh
README.md
screenshot.png

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/golbin/gw

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd gw

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. 공식 설치 스크립트

쉬움 추천

사전 준비물

Homebrew macOS/Linux용 패키지 매니저입니다.
Scoop Windows용 패키지 매니저입니다.

brew install golbin/tap/gw

Homebrew로 이미 빌드된 패키지를 바로 설치합니다. 소스 빌드가 필요 없습니다.

scoop install gw

Scoop으로 바로 설치합니다 (Windows).

curl -fsSL https://raw.githubusercontent.com/golbin/gw/main/install.sh | bash

공식 설치 스크립트를 다운로드해서 바로 실행합니다. 이 한 줄로 필요한 게 자동으로 설치됩니다.

✅ 설치 후 새 터미널을 열고, 프로그램의 버전 확인 명령(예: --version)으로 정상 설치됐는지 확인하세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

3. Rust

보통

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Rust (rustup) rustup으로 설치하면 cargo도 함께 설치됩니다.

rust = "cargo test"

이 명령어를 터미널에 그대로 입력해 실행하세요.

cargo build

Rust 프로젝트를 컴파일합니다.

cargo check

이 명령어를 터미널에 그대로 입력해 실행하세요.

✅ cargo build가 에러 없이 끝나면 성공입니다. target/ 폴더에 실행 파일이 생성됩니다.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# gw

gw is a cross-platform CLI that wraps `git worktree` for multi-agent/parallel work management.

Examples:

![Examples](https://raw.githubusercontent.com/golbin/gw/main/screenshot.png)

## Install

### Homebrew

```bash
brew install golbin/tap/gw
```

### Scoop

```powershell
scoop bucket add golbin https://github.com/golbin/scoop-bucket
scoop install gw
```

### install.sh (macOS/Linux)

```bash
curl -fsSL https://raw.githubusercontent.com/golbin/gw/main/install.sh | bash
```

## Quick start

```bash
gw add demo
gw cd demo
touch demo.md
gw status
gw apply demo
```

Tip: jump to repo root with `gw cd` (or `gw cd root`).

Common navigation:

```bash
gw cd root
gw cd <name>
```

## Shell integration (recommended)

Install a wrapper so `gw cd` changes the current shell directory. This auto-detects your shell and installs without prompts:

```bash
gw shell-init --install
```

Fully automatic (install + apply for current session):

```bash
eval "$(gw shell-init)"
```

To print the integration script without installing, run `gw shell-init <shell>` (bash/zsh/fish/powershell).

## Command quick reference

This table is the fastest way to learn the core commands, shortcuts, and aliases.

| Command                   | Alias             | Shortcut               | Description                        |
| ------------------------- | ----------------- | ---------------------- | ---------------------------------- |
| `gw add <name>`           | `gw new <name>`   | `gw a <name>`          | create worktree                    |
| `gw del <name>`           | `gw rm <name>`    | `gw d <name>`          | remove worktree                    |
| `gw list`                 | `gw ls`           |                        | list worktrees                     |
| `gw status`               |                   | `gw st`                | status snapshot                    |
| `gw apply <name>`         | `gw merge <name>` | `gw ap <name>`         | apply result (merge/squash/rebase) |
| `gw sync <name>`          |                   | `gw sy <name>`         | update base then sync              |
| `gw sync --all`           |                   | `gw sy -A`             | sync all                           |
| `gw verify <name>`        |                   | `gw v <name>`          | verification bundle                |
| `gw note <name> "<text>"` |                   | `gw n <name> "<text>"` | add note                           |
| `gw info <name>`          | `gw show <name>`  | `gw i <name>`          | view notes/meta                    |
| `gw lock <name>`          |                   | `gw lk <name>`         | lock from delete/cleanup           |
| `gw unlock <name>`        |                   | `gw ul <name>`         | unlock                             |
| `gw gc`                   |                   | `gw g`                 | print cleanup candidates           |
| `gw cd <name>`            |                   | `gw c <name>`          | output worktree path               |
| `gw exec <cmd>`           |                   | `gw x <cmd>`           | run command on worktrees           |

## Detailed usage

### Global options

```
-h, --help     show help
-V, --version  show version
-v, --verbose  verbose output
-q, --quiet    minimal output (errors only)
--color <when> color output (auto, always, never)
--json         JSON output (supported commands only)
```

### gw add <name>

Create a worktree.

Options:

```
-b, --base <branch>    base branch (auto if omitted)
-B, --branch <branch>  branch name to create/use (default: wt/<name>)
--path <dir>           worktree path (default: .worktrees/<name>)
```

### gw del <name>

Remove a worktree.

Options:

```
-f, --force          remove even if dirty
-D, --delete-branch  delete branch too
```

### gw list

List worktrees (git worktree list).

### gw status

Show a pretty table with branch, dirty summary, last commit, and the most recent
uncommitted file changes with human-readable time.

Options:

```
--changes-detail  show staged/unstaged/untracked breakdown
--recent <n>      max recent files to show (default: 3)
```

### gw apply <name>

Apply a worktree branch into a target.

Options:

```
-t, --target <branch>  target branch (default: current)
--merge                merge with --no-ff (default)
--squash               merge with --squash
--rebase               rebase onto target
-c, --cleanup           cleanup worktree and branch on success
```

### gw sync <name> / gw sync --all

Sync worktree branches to the latest base.

Options:

```
--base <branch>  base branch (auto if omitted)
--rebase         rebase (default)
--merge          merge instead of rebase
-A, --all        target all worktrees
```

### gw verify <name>

Run verification commands (test/lint/typecheck) based on project type.

### gw note <name> "<text>"

Add a note to the worktree metadata.

### gw info <name>

Show worktree metadata and notes.

### gw lock <name> / gw unlock <name>

Lock or unlock a worktree from delete/cleanup/gc.

### gw gc

Print cleanup candidates (use `--prune` to delete).

### gw cd <name>

Print worktree path for shell integration.

Use `gw cd` or `gw cd root` to print the repo root.

With shell integration installed, `gw cd <name>` also changes the current shell directory.

### gw exec <cmd>

Run a command across worktrees.

Options:

```
-A, --all          target all worktrees (default)
-w, --worktree     target specific worktrees (repeatable)
--parallel         run in parallel (default: sequential)
--fail-fast        stop on first failure
```

### gw completion <shell>

Generate shell completion scripts.

## Configuration

### Environment variables

```
GW_HOME           gw config/tools directory (default: ~/.gw)
GW_DEFAULT_BASE   default base branch
GW_WORKTREES_DIR  worktree root directory name (default: .worktrees)
GW_LOG            log level: error|warn|info|debug|trace (default: warn)
GW_NO_COLOR       disable color when set to 1
```

### Config files

- Global: `~/.gw/config.toml`
- Project: `<repo_root>/.gw/config.toml` (overrides global)

Example:

```toml
[defaults]
base = "main"
worktrees_dir = ".worktrees"
branch_prefix = "wt/"

[gc]
stale_days = 7

[verify]
rust = "cargo test"
node = "npm test"
python = "pytest"
```

### Metadata and locks

```
<repo_root>/.gw/
├── config.toml
├── meta.json
└── locks/
    └── <name>.lock
```

## Requirements

- Git 2.20+
- Rust 1.70+ (for builds)

## License

MIT

## Development

```bash
cargo build
cargo check
```