Skip to content

docs: aqua/README.md #17

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
officel merged 1 commit into from
Jan 2, 2026
Merged

docs: aqua/README.md #17

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
89 changes: 31 additions & 58 deletions aqua/README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,36 @@
# .config/aqua
# aqua

- [CLI バージョン管理ツールの aqua を使うようになって少し経ったので少しまとめておく](https://zenn.dev/raki/articles/2024-05-16_aqua)

## tl;dr

```bash
# このリポジトリのルートディレクトリ（このファイルのひとつ上のディレクトリ）
dotfiles $ pwd
/home/raki/officel/dotfiles

# aqua の設定は XDG_BASE_DIRECTORY の XDG_CONFIG_HOME/aqua に置いてある、ということ
dotfiles $ ls -l ~/.config/aqua
lrwxrwxrwx 1 raki raki 32 1月 2 02:56 /home/raki/.config/aqua -> /home/raki/officel/dotfiles/aqua

# 中身はこのディレクトリ
dotfiles $ ls -l ~/.config/aqua/
合計 16
-rwxrwxrwx 1 raki raki 2823 12月 31 13:34 README.md
-rwxrwxrwx 1 raki raki 4470 1月 3 03:58 Taskfile.yml
-rwxrwxrwx 1 raki raki 1683 1月 3 03:59 aqua.yaml

# どこからでも task は呼べる
dotfiles $ t -t aqua/Taskfile.yml
task: Available tasks for this project:
* alias: show alias for aqua (aliases: aa)
* git: auto git, use -- COMMIT TITLE (aliases: ag)
* packages: random package from aqua.yaml (aliases: ap)
* update: Run aqua update, install, list for globally (aliases: au)

reminder this package kubernetes/kubectl@v1.35.0
```

## aqua.yaml のパッケージをソート

```bash
Expand All @@ -12,66 +41,10 @@ yq '.packages |= sort_by(.name | split("/") | .[1])' aqua.yaml
- 管理に迷ったらソートしておくと見やすい（かも）
- 関連ツール毎にまとめたい時は [Split the list of packages](https://aquaproj.github.io/docs/guides/split-config) を使うとよさげ

## .bashrc
## .bashrc @todo 整理予定

```bash
# cli version manager aqua
export PATH="$(aqua root-dir)/bin:$PATH"
export AQUA_GLOBAL_CONFIG=${XDG_CONFIG_HOME:-$HOME/.config}/aqua/aqua.yaml
```

## alias

```bash
alias aq='aqua'
alias aqcd="cd ${XDG_CONFIG_HOME:-$HOME/.config}/aqua/"
alias aqgi='aqua generate -i -o $AQUA_GLOBAL_CONFIG'
alias aqia='aqua install --all'
alias aqli='aqua list --installed --all | sort'
alias aqup='aqua update'
```

## task

```bash
$ aqcd
aqua $ task
task: Available tasks for this project:
* aqua:alias: show alias for aqua (aliases: aa)
* aqua:git: auto git, use -- COMMIT TITLE (aliases: ag)
* aqua:packages: random package from aqua.yaml (aliases: ap)
* aqua:update: Run aqua update, install, list for globally (aliases: au)

reminder this package cli/cli@v2.76.2

aqua $ task ls
task: Available tasks for this project:
* _git:
* _git:auto:
* _git:gh:
* aqua:alias: show alias for aqua (aliases: aa)
* aqua:git: auto git, use -- COMMIT TITLE (aliases: ag)
* aqua:packages: random package from aqua.yaml (aliases: ap)
* aqua:update: Run aqua update, install, list for globally (aliases: au)
* default:
* util:list: (aliases: ul, ls)
* util:summary: (aliases: us, la)

aqua $ task au
<omit> aqua up が実行される

aqua $ task ag
<omit> git add aqua.yaml から commit, push, gh pr create, gh pr merge まで自動化
```

## direnv

- .direnv と .env で GitHub token を設定した
- [Tips ｜ aqua CLI Version Manager 入門](https://zenn.dev/shunsuke_suzuki/books/aqua-handbook/viewer/tips#github_token%2C-aqua_github_token-%E3%82%92%E8%A8%AD%E5%AE%9A%E3%81%97%E3%81%A6-rate-limit-%E3%82%92%E5%9B%9E%E9%81%BF%E3%81%99%E3%82%8B)

# related my projects

- [officel/config_aqua: .config/aqua](https://github.com/officel/config_aqua)
- [officel/config_bash: .config/bash](https://github.com/officel/config_bash)
- [officel/config_git: .config/git](https://github.com/officel/config_git)
- [officel/config_task: .config/task](https://github.com/officel/config_task)