ローカルGitを使用する

Altifigence CLIで保存済みの変更を確認し、選択したファイルをステージングし、コミットを調べ、ローカルブランチを切り替えます。

Linux上のAltifigence CLI 0.1.9を既存のローカルGitプロジェクトで使用します。/home/me/designをプロジェクトの絶対ディレクトリに、rtl/top.svをご自身のファイルに置き換えてください。

変更を確認する

alti ide workspace git status --project /home/me/design
alti ide workspace git diff --project /home/me/design rtl/top.sv
alti ide workspace git history --project /home/me/design --limit 20 --skip 0

main上で変更のないプロジェクトの場合、statusは次を返します。

{"branch":"main","changes":[],"ok":true,"staged":[],"unstaged":[],"untracked":[]}

Historyは、各コミットのid、parents、author、authoredAt、subjectを含むcommits配列を返します。--limitには1から200を指定し、--skipで履歴を移動してください。

選択したファイルをステージングしてコミットする

ファイルを保存して確認し、ステージングした後、コミットする前にステージ済みの差分を確認してください。

alti ide workspace git stage --project /home/me/design rtl/top.sv
alti ide workspace git diff --project /home/me/design rtl/top.sv --staged
alti ide workspace git commit --project /home/me/design --message "Update top module"

Stageは{"status":"staged"}を返します。コミットが成功すると{"status":"committed"}を返します。ステージング領域からファイルを外すには、次を実行してください。

alti ide workspace git unstage --project /home/me/design rtl/top.sv

コミットとブランチを調べる

履歴からidをコピーしてCOMMIT_IDに指定してください。コミット、その保存済みファイル、リポジトリのrefs、worktreesを読み取ります。

alti ide workspace git commit-detail --project /home/me/design COMMIT_ID
alti ide workspace git commit-file --project /home/me/design COMMIT_ID rtl/top.sv
alti ide workspace git refs --project /home/me/design
alti ide workspace git worktrees --project /home/me/design

reviewという既存のローカルブランチに切り替えるには、変更を保存してコミットするか、別の場所に保持してから、次を実行してください。

alti ide workspace git switch --project /home/me/design review

拒否されたブランチ切り替えに対処する

"save and commit or separately preserve local changes before switching branches"と表示された場合は、statusを実行して変更ファイルを確認してください。コミットするか、別の場所に保持してください。statusをもう一度実行し、プロジェクトに変更がなくなったら切り替えを再試行してください。

CLIで最初の操作を成功させる