dotfiles

My configuration for Zsh, Mise, Just, and more.

Installation

Requires curl and git.

bash -c "$(curl -fsSL https://raw.githubusercontent.com/hironow/dotfiles/main/install.sh)"

Note

Mac, Linux, Windows(WSL内Linux)へ対応

usage

# just (task runner)
just help

just sync-agents-preview
just sync-agents

just update-all
just dump

# diagnostics
just self-check
# run with quick validate tests (needs Docker)
just self-check with_tests=1
just doctor
just validate-path-duplicates

# uv on mise
mx uv sync

# just on mise
mx just --list

# mise env
mx dotenvx run -- mise set
# mise env with github credentials (use gh extension)
gh do -- mise set

# set env by dotenvx (encrypted)
mx dotenvx set HELLO World
# set env by mise (plain, unencrypted)
mx mise set WORLD=hello

tests (docker required)

# run all sandbox tests
just test

# run by pytest marker (install/validate/versions/deploy/check)
just test-mark marker=validate

# verify install.sh (docker required)
just test-install

install options

# full install
bash ./install.sh

# lightweight (skip heavy tools)
INSTALL_SKIP_HOMEBREW=1 INSTALL_SKIP_GCLOUD=1 INSTALL_SKIP_ADD_UPDATE=1 bash ./install.sh

setup for https localhost

# check A record for localhost -> 127.0.0.1
dig localhost.hironow.dev

# create/update cert for https
sudo certbot certonly --manual --preferred-challenges dns -d localhost.hironow.dev --config-dir ${config_root}/private/certificates

# check simple-server for https localhost
cd tools/simple-server
sudo mise x -- go run main.go

Tools

• Tools: Collection of utility scripts and tools (e.g., RTTM converter, simple server).

references

• mise
• uv
• gh do
• localhost
• dotenvx
• browser toolbox
• smarthome webrtc tool
• trickle ice checker

mcp setup

claude mcp add -s user chrome-devtools bunx chrome-devtools-mcp@latest
claude mcp add -s user -t http deepwiki https://mcp.deepwiki.com/mcp

# latest documentation MCP per user
claude mcp add -s user -t http bun https://bun.com/docs/mcp
claude mcp add -s user -t http cloudflare https://docs.mcp.cloudflare.com/mcp
claude mcp add -s user -t http vercel https://mcp.vercel.com
claude mcp add -s user -t http livekit-docs https://docs.livekit.io/mcp
claude mcp add -s user -t http openai https://developers.openai.com/mcp
# -- Google Cloud: https://developers.google.com/knowledge/mcp#gcloud-cli
YOUR_PROJECT_ID=<your-project-id>
gcloud beta services mcp enable developerknowledge.googleapis.com --project=$YOUR_PROJECT_ID
# -- needs credentials setup
# gcloud auth login
# gcloud auth application-default login
gcloud services api-keys create --project=$YOUR_PROJECT_ID --display-name="DK API Key"
YOUR_API_KEY=<your-keyString>
claude mcp add google-dev-knowledge -s user -t http https://developerknowledge.googleapis.com/mcp --header "X-Goog-Api-Key: $YOUR_API_KEY"
# -- AWS: https://awslabs.github.io/mcp/servers/aws-knowledge-mcp-server/
claude mcp add -s user -t http aws-knowledge-mcp-server https://knowledge-mcp.global.api.aws
# -- k6: https://grafana.com/docs/k6/latest/release-notes/v1.6.0/#introducing-mcp-k6-ai-assisted-k6-script-writing-mcp-k6
claude mcp add --scope=user --transport=stdio k6 -- docker run --rm -i grafana/mcp-k6

# specific (needs copy for other agents' directory) per project
claude mcp add -s project -t http jaeger http://localhost:16687/mcp

MCP catalog refs.

• https://hub.docker.com/u/mcp
• https://mcpmarket.com/en/categories/official

skill setup

justfile経由で CLAUDE_CONFIG_DIR を切り替えつつ操作できる:

just skills ls                # デフォルトconfigでスキル一覧
just skills add <repo> --all  # スキル追加
just env=a skills ls -g       # ~/.claude-work-a 向け
just env=b skills ls -g       # ~/.claude-work-b 向け
just env=c skills ls -g       # ~/.claude-work-c 向け
just env=d skills ls -g       # ~/.claude-work-d 向け
just env=p skills ls -g       # ~/.claude (personal) 向け

just skills add vercel-labs/agent-skills
just skills add modelcontextprotocol/ext-apps
just skills add wandb/skills
just skills add https://github.com/googleworkspace/cli
# browser: https://github.com/vercel-labs/agent-browser?tab=readme-ov-file#agentsmd--claudemd
just skills add vercel-labs/agent-browser

Skill catalog refs.

• https://skills.sh/

git setup

# avoid merge commits when pulling
git config --global pull.rebase true

win setup (WSL)

# install vscode cli for wsl
curl -Lk 'https://code.visualstudio.com/sha/download?build=stable&os=cli-alpine-x64' -o vscode_cli.tar.gz
tar -xzf vscode_cli.tar.gz
mv code ~/.local/bin/code-cli

# login vscode tunnel
~/.local/bin/code-cli tunnel user login

# check vscode tunnel initial setup
code-cli tunnel --accept-server-license-terms --name test-my-wsl

# start service
code-cli tunnel service install
code-cli tunnel status

dotenvx setup (for LLM)

# init
sudo chmod 600 .env.keys
dotenvx set HELLO "WORLD"

# change to -rw-------
sudo chmod 600 .env.keys

# then: NG
dotenvx decrypt --stdout
EACCES: permission denied, open '.env.keys'

# then: OK
sudo dotenvx decrypt --stdout

As a defensive measure, I want to not trust the deny option of various agents (experimental).

markdown+

• https://docs.github.com/en/contributing/writing-for-github-docs/using-yaml-frontmatter
• https://github.com/mdx-js/mdx