8000 docs(readme): declare session tools via [session] packages, not min add --session by norrietaylor · Pull Request #946 · gominimal/minimal · GitHub
[go: up one dir, main page]
Skip to content

docs(readme): declare session tools via [session] packages, not min add --session #946

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

Closed
norrietaylor wants to merge 2 commits into from
Closed

docs(readme): declare session tools via [session] packages, not min add --session #946

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
352bced
docs(readme): declare session tools via [session] packages, not min a…
norrietaylor Jul 23, 2026
bf1805f
docs(readme): describe the actual min init scaffold package list
norrietaylor Jul 24, 2026
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
18 changes: 14 additions & 4 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -80,9 +80,14 @@ In this example we'll create a new git repo from within a Minimal sandbox, using
mkdir -p ~/projects/foo
cd ~/projects/foo

# create and update a minimal.toml file
# create a minimal.toml file
min init
min add --session git gh claude-code

# declare your session's tools by editing the scaffolded [session] table in
# minimal.toml; extend its packages list from ["base", "vim"] (don't add a
# second [session] table):
# [session] # min attach
# packages = ["base", "vim", "git", "gh", "claude-code"]

# start and enter a sandbox, which copies up the CWD file tree into the sandbox
min activate --attach .
Expand All @@ -104,9 +109,14 @@ Once you have created the PAT, copied it into your keychain (e.g. `security add-
mkdir -p ~/projects/foo
cd ~/projects/foo

# create and update a minimal.toml file
# create a minimal.toml file
min init
min add --session git gh claude-code mermaid-cli kittyview less emacs

# declare your session's tools by editing the scaffolded [session] table in
# minimal.toml; extend its packages list from ["base", "vim"] (don't add a
# second [session] table):
# [session] # min attach
# packages = ["base", "vim", "git", "gh", "claude-code", "mermaid-cli", "kittyview", "less", "emacs"]

# copy the GitHub PAT to your clipboard from your macOS keychain
security find-generic-password -w -s "PAT-foo-repo" -a "my-mac-user-name" | pbcopy
Expand Down
0