asutils 0.2.27

Personal CLI utilities

asutils

Personal CLI utilities with a focus on Claude Code integration.

Install

pip install asutils

Quick Start: Claude Code Setup

One command to configure Claude Code with permissions, skills, and agents:

asutils claude setup

This installs:

• Permission profiles (auto-approve common dev operations)
• Bundled skills (reference docs for hooks, TTS, etc.)
• Bundled agents (code-review)

Commands

General Utilities

Command	Description
asutils repo init [name]	Scaffold new Python project
asutils git sync	Quick add, commit, push
asutils publish bump <major|minor|patch>	Bump version
asutils publish release	Build and publish to PyPI

Claude Code: Skills

Skills are markdown files that Claude Code loads as context when invoked.

Command	Description
asutils claude skill list	List bundled & installed skills
asutils claude skill add <name>	Install a skill to ~/.claude/skills/
asutils claude skill add --bundle=all	Install all bundled skills
asutils claude skill remove <name>	Remove an installed skill
asutils claude skill show <name>	View skill content

Bundled Skills:

• claude-hooks - Reference for creating Claude Code hooks

Epic Skills Bundle (for Epic Games employees):

• epic/jira - JIRA issue management for Epic's Atlassian Cloud
• epic/confluence - Confluence search via asutils CLI

Install with: asutils claude skill add --bundle epic

Claude Code: Permission Profiles

Permission profiles auto-approve tool calls matching defined rules, reducing permission prompts.

Command	Description
asutils claude permission install	Install profiles and hook
asutils claude permission list	List available profiles
asutils claude permission default <name>	Set default profile
asutils claude permission status	Show current configuration
asutils claude permission uninstall	Remove profiles and hook

Bundled Profiles:

• default - Conservative, passthrough everything
• dev - Auto-approve common dev tools (git, npm, pytest, etc.)
• readonly - Only allow read operations
• yolo - Allow everything except destructive operations

Usage:

# Use dev profile (auto-approves common operations)
asutils claude permission default dev

# Override per-session
CLAUDE_PROFILE=readonly claude

Claude Code: Agents

Agents are specialized subagents with defined tools and prompts.

Command	Description
asutils claude agent list	List bundled & installed agents
asutils claude agent add <name>	Install an agent
asutils claude agent add --all	Install all bundled agents
asutils claude agent remove <name>	Remove an agent
asutils claude agent show <name>	View agent definition

Bundled Agents:

• code-review - Review code for bugs, security issues, and quality

Claude Code: Text-to-Speech (TTS)

Read Claude's responses aloud using macOS text-to-speech.

Command	Description
asutils claude tts install	Install TTS hooks
asutils claude tts enable --always	Enable for all sessions
asutils claude tts disable	Disable persistent TTS
asutils claude tts status	Show TTS configuration
asutils claude tts test "Hello"	Test TTS output
asutils claude tts voices	List available macOS voices
asutils claude tts config	Configure voice, rate, etc.
asutils claude tts uninstall	Remove TTS hooks

Usage:

# Install hooks
asutils claude tts install

# Enable for all sessions
asutils claude tts enable --always

# Or toggle per-session in Claude Code
/tts

# Configure voice and speed
asutils claude tts config --voice "Alex" --rate 200

How TTS Works:

1. The /tts command toggles TTS mode and instructs Claude to use <speak> tags
2. A Stop hook fires after each response and extracts spoken content
3. Text is read aloud using macOS say command
4. Terminal window is focused (configurable)

Configuration (~/.claude/tts-config.yaml):

voice: Samantha        # macOS voice name
rate: 175              # Words per minute
focus_window: true     # Focus terminal after speaking
terminal_app: auto     # auto | Terminal | iTerm | none
always_enabled: false  # Persistent mode

Confluence Search (Epic Games)

Search Epic's internal Confluence wiki directly from the command line.

Command	Description
asutils confluence search "query"	Search for pages
asutils confluence search "q1" "q2" --parallel	Multi-query parallel search
asutils confluence page <id>	Get page content (markdown)
asutils confluence spaces	List available spaces
asutils confluence cql 'text~"term"'	Raw CQL search
asutils confluence children <id>	Get child pages

Prerequisites:

• Set JIRA_API_TOKEN environment variable (same token works for Confluence)
• Run asutils epic setup to configure

Usage:

# Search across all Confluence
asutils confluence search "deployment process"

# Parallel search with multiple queries
asutils confluence search "authentication" "OAuth" "SSO" --parallel

# Get full page content
asutils confluence page 12345678

# Search within a specific space
asutils confluence search "API" --space DEV

Perforce Explorer (Epic Games)

Explore Epic's Perforce depot directly from the command line.

Quick Start:

asutils p4 setup  # Interactive setup (installs p4, configures connection)

Command	Description
asutils p4 setup	Interactive setup wizard
asutils p4 ls <path>	List directories at depot path
asutils p4 find <pattern>	Find files matching pattern
asutils p4 tree <path>	Show depot structure as tree
asutils p4 branches <depot>	List available branches
asutils p4 info <path>	Get file details (fstat)
asutils p4 history <path>	Show file change history
asutils p4 cat <path>	Print file contents
asutils p4 cl <number>	Show changelist details
asutils p4 where <path>	Show local workspace mapping
asutils p4 aliases	Show available depot path aliases
asutils p4 verify	Verify P4 connection
asutils p4 status	Show P4 configuration

Prerequisites:

• Perforce client (p4) installed
• P4CONFIG or environment variables set (P4PORT, P4USER, P4CLIENT)

Depot Aliases:

Alias	Path
fortnite, fn	//Fortnite/Main/
valkyrie, fn-valkyrie	//Fortnite/Dev-Valkyrie/
ue5	//UE5/Main/
ue4	//UE4/Main/
eos	//EOSSDK/Main/
3rdparty	//depot/3rdParty/
tools	//depot/InternalTools/
plugins	//GamePlugins/

Usage:

# List using aliases
asutils p4 ls fortnite
asutils p4 ls valkyrie        # Use Dev-Valkyrie branch
asutils p4 ls ue5 -f          # Include files

# Discover branches
asutils p4 branches fortnite  # All Fortnite branches
asutils p4 branches fn --dev  # Only Dev branches
asutils p4 branches fn -f "*Valkyrie*"

# Find files by pattern
asutils p4 find "*.Build.cs" -p fortnite -l 50
asutils p4 find "*Controller*" -p //Fortnite/Dev-Valkyrie/Source/

# Tree view
asutils p4 tree valkyrie -d 3

# File details
asutils p4 info //Fortnite/Main/Build.cs
asutils p4 cat //Fortnite/Main/Build.cs

# Verify connection
asutils p4 verify

Epic Setup

One-command setup for Epic Games integrations.

Command	Description
asutils epic setup	Configure Epic integrations and install skills
asutils epic status	Show integration status
asutils epic verify	Test Confluence authentication

Usage:

# Full setup (creates config, verifies auth, installs skills)
asutils epic setup

# Check status
asutils epic status

Development

git clone https://github.com/afspies/asutils
cd asutils
uv pip install -e ".[dev]"

License

MIT