## ๆฆ่ฆ
[[GitButler]]ใๆฐใซใชใฃใใฎใง่ฉฆใใฆใฟใใappใงใฏใชใ[[CLI]]ใฎใปใใ
## ใคใณในใใผใซ
```console
curl -fsSL https://gitbutler.com/install.sh | sh
```
## ใปใใใขใใ
```console
$ but
The current project is not configured to be managed by GitButler.
No GitButler project found at .
In order to manage projects with GitButler, we need to do some changes:
- Switch you to a special `gitbutler/workspace` branch to enable parallel branches
- Install Git hooks to help manage the tooling
You can go back to normal git workflows at any time by either:
- Running `but teardown`
- Manually checking out a normal branch with `git checkout <branch>`
Would you like to run setup now? [Y/n]:
```
`Y` ใๅ
ฅๅใ
```console
Setting up GitButler project...
โ Adding repository to GitButler project registry
โ Repository added to project registry
โ Configuring default target branch
No push remote found, creating gb-local remote...
โ Created gb-local remote tracking main
โ Set default target to: gb-local/main
GitButler project setup complete!
Target branch: gb-local/main
Remote: gb-local
Setting up your project for GitButler tooling. Some things to note:
- Switching you to a special `gitbutler/workspace` branch to enable parallel branches
- Installing Git hooks to help manage commits on the workspace branch
To undo these changes and return to normal Git mode, either:
- Directly checkout a branch (`git checkout main`)
- Run `but teardown`
More info: https://docs.gitbutler.com/workspace-branch
โโโโโโโ โโโโโโโ โโโโโโโ โโโ โโโโโโโโโโโโ
โโโโโโโโโ โโโโโโโโโ โโโโโโโโโโโ โโโโโโโโโโโโ
โโ โโโโโโ โโ โโโโโโโโโโโ โโโ โโโ
โโโโโโโโโ โโโโโโโโโ โโโโโโโโโโโ โโโ โโโ
โโโโโโโ โโโโโโโ โโโโโโโโโโโโโโโโโ โโโ
The command-line interface for GitButler
$ but branch new <name> Create a new branch
$ but status View workspace status
$ but commit -m <message> Commit changes to current branch
$ but push Push all branches
$ but teardown Return to normal Git mode
Learn more at https://docs.gitbutler.com/cli-overview
Initiated a background sync...
โญโzz [unstaged changes]
โ pu A .gitignore
โ rl A README.md
โ to A biome.json
โ vz A biome.json.tmp
โ uz A bun.lock
โ xt A bunfig.toml
โ py A index.ts
โ sz A package.json
โ ty A tsconfig.json
โ
โโญโbr [t-branch-1] (no commits)
โโฏ
โ
โด 03aaa98 [gb-local/main] 2026-04-10 Initial empty commit
Hint: run `but diff` to see uncommitted changes and `but stage <file>` to stage them to a branch
```
## ใใฉใณใใไฝๆใใฆใณใใใใใ
```console
๏ ๎ v1.3.11 ~/tmp/dayjs-sandbox
๓ฐข ๏ gitbutler/workspace ๏ 9 โฏโฏโฏ but branch new branch-1
Initiated a background sync...
โ Created branch branch-1
๏ ๎ v1.3.11 ~/tmp/dayjs-sandbox
๓ฐข ๏ gitbutler/workspace ๏ 9 โฏ but status
Initiated a background sync...
โญโzz [unstaged changes]
โ pu A .gitignore
โ rl A README.md
โ to A biome.json
โ vz A biome.json.tmp
โ uz A bun.lock
โ xt A bunfig.toml
โ py A index.ts
โ sz A package.json
โ ty A tsconfig.json
โ
โโญโg0 [t-branch-1] (no commits)
โโฏ
โ
โโญโh0 [branch-1] (no commits)
โโฏ
โ
โด 03aaa98 [gb-local/main] 2026-04-10 Initial empty commit
Hint: run `but diff` to see uncommitted changes and `but stage <file>` to stage them to a branch
๏ ๎ v1.3.11 ~/tmp/dayjs-sandbox
๓ฐข ๏ gitbutler/workspace ๏ 9 โฏ but commit -m "test"
Initiated a background sync...
Multiple stacks found. Choose one to commit to:
1. t-branch-1
2. branch-1
Enter selection (1-2):
> 1
โ Created commit 8b6e8bb on branch t-branch-1
```
ใใฎใใจ่ฒใ
ๆไฝใใฆ...
```console
๓ฐข ๏ gitbutler/workspace ๓ฐผ 4 โฏ but
Last fetch was 16m ago. Initiated a background sync...
โญโzz [unstaged changes]
โ pu A .gitignore
โ to A biome.json
โ vz A biome.json.tmp
โ ty A tsconfig.json
โ
โโญโg0 [branch-1]
โโ 2435c79 hoge
โโ
โโโh0 [t-branch-1]
โโ 0d9d4b5 add2
โโ 7488e15 Add README
โโฏ
โ
โด 03aaa98 [gb-local/main] 2026-04-10 Initial empty commit
Hint: run `but diff` to see uncommitted changes and `but stage <file>` to stage them to a branch
```
## Gitใซๆปใ