@staff0rd/assist
v0.134.0
Published
A CLI tool for enforcing determinism in LLM development workflow automation.
Downloads
5,906
Readme
assist
A CLI tool for enforcing determinism in LLM development workflow automation.
See devlog for latest features.
Installation
You can install assist globally using npm:
npm install -g @staff0rd/assist
assist syncLocal Development
# Clone the repository
git clone [email protected]:staff0rd/assist.git
cd assist
# Install dependencies
npm install
# Build the project
npm run build
# Install globally
npm install -g .After installation, the assist command will be available globally. You can also use the shorter ast alias.
Claude Commands
/comment- Add pending review comments to the current PR/commit- Commit only relevant files from the session/devlog- Generate devlog entry for the next unversioned day/next-backlog-item- Pick and implement the next backlog item/pr- Raise a PR with a concise description/refactor- Run refactoring checks for code quality/restructure- Analyze and restructure tightly-coupled files/review-comments- Process PR review comments one by one/jira- View a Jira work item/journal- Append a journal entry summarising recent work, decisions, and notable observations/standup- Summarise recent journal entries as a standup update/sync- Sync commands and settings to ~/.claude/inspect- Run .NET code inspections on changed files/screenshot- Capture a screenshot of a running application window/seq- Query Seq logs from a URL or filter expression/verify- Run all verification commands in parallel/transcript-format- Format meeting transcripts from VTT files/transcript-summarise- Summarise transcripts missing summaries/voice-setup- Download required voice models (VAD, STT)/voice-start- Start the voice interaction daemon/voice-stop- Stop the voice interaction daemon/voice-status- Check voice daemon status/voice-logs- Show recent voice daemon logs
CLI Commands
assist init- Initialize project with VS Code and verify configurationsassist new vite- Initialize a new Vite React TypeScript projectassist new cli- Initialize a new tsup CLI projectassist sync- Copy command files to~/.claude/commandsassist commit status- Show git status and diffassist commit <message>- Commit staged changes with validationassist commit <message> [files...]- Stage files and create a git commit with validationassist prs- List pull requests for the current repositoryassist prs list-comments- List all comments on the current branch's pull requestassist prs fixed <comment-id> <sha>- Reply with commit link and resolve threadassist prs wontfix <comment-id> <reason>- Reply with reason and resolve threadassist prs comment <path> <line> <body>- Add a line comment to the pending reviewassist news- Start the news web UI showing latest RSS feed items (same asnews web)assist news add [url]- Add an RSS feed URL to the configassist news web [-p, --port <number>]- Start a web view of the news feeds (default port 3001)assist backlog- Start the backlog web UI (same asbacklog web)assist backlog init- Create an empty assist.backlog.ymlassist backlog list [--status <type>] [-v]- List all backlog items with status iconsassist backlog add- Add a new backlog item interactively (prompts for type: story/bug)assist backlog start <id>- Set a backlog item to in-progressassist backlog done <id>- Set a backlog item to doneassist backlog delete <id>- Delete a backlog itemassist backlog web [-p, --port <number>]- Start a web view of the backlog (default port 3000)assist roam auth- Authenticate with Roam via OAuth (opens browser, saves tokens to ~/.assist.yml)assist roam show-claude-code-icon- Forward Claude Code hook activity to Roam local APIassist run <name> [params...]- Run a configured command from assist.yml (positional params are matched toparamsconfig; supportsprearray of commands to run first)assist run add- Add a new run configuration to assist.yml and create a Claude command fileassist config set <key> <value>- Set a config value (e.g. commit.push true)assist config get <key>- Get a config valueassist config list- List all config valuesassist verify- Run all verify:* commands in parallel (from run configs in assist.yml and scripts in package.json)assist verify all- Run all checks, ignoring diff-based filtersassist verify init- Add verify scripts to a projectassist verify hardcoded-colors- Check for hardcoded hex colors in src/ (supportshardcodedColors.ignoreglobs in config)assist lint [-f, --fix]- Run lint checks for conventions not enforced by biomejs (use-fto auto-fix)assist lint init- Initialize Biome with standard linter configassist refactor check [pattern]- Check for files that exceed the maximum line countassist refactor ignore <file>- Add a file to the refactor ignore listassist refactor rename file <source> <destination>- Rename/move a TypeScript file and update all imports (dry-run by default, use--applyto execute)assist refactor rename symbol <file> <oldName> <newName>- Rename a variable, function, class, or type across the project (dry-run by default, use--applyto execute)assist refactor restructure [pattern]- Analyze import graph and restructure tightly-coupled files into nested directoriesassist devlog list- Group git commits by dateassist devlog next- Show commits for the day after the last versioned entryassist devlog repos- Show which github.com/staff0rd repos are missing devlog entriesassist devlog skip <date>- Add a date to the skip listassist devlog version- Show current repo name and version infoassist cli-hook- PreToolUse hook for auto-approving read-only CLI commands (reads fromassist.cli-reads, also auto-approves read-onlygh apicalls). Supports compound commands (|,&&,||,;) by checking each sub-command independentlyassist cli-hook add <cli>- Discover a CLI's commands and auto-permit read-only onesassist cli-hook check <command>- Check whether a command would be auto-approved bycli-hookassist update- Update assist to the latest version and sync commandsassist vscode init- Add VS Code configuration filesassist deploy init- Initialize Netlify project and configure deploymentassist deploy redirect- Add trailing slash redirect script to index.htmlassist notify- Show desktop notification from JSON stdin (supports macOS, Windows, WSL)assist status-line- Format Claude Code status line from JSON stdinassist dotnet inspect [sln]- Run JetBrains inspections on changed .cs files to find dead codeassist dotnet inspect [sln] --scope all- Inspect the full solutionassist dotnet inspect [sln] --scope base:<ref>- Inspect all .cs files changed since diverging from a base ref (e.g.--scope base:mainfor a full PR)assist dotnet inspect [sln] --scope commit:<ref>- Inspect .cs files changed in a specific commitassist dotnet inspect [sln] --only <ids...>- Show only the specified issue type IDs (e.g.--only CommentedCode)assist dotnet inspect [sln] --suppress <ids...>- Suppress specific issue type IDs on the command lineassist dotnet inspect [sln] --roslyn- Use Roslyn analyzers via msbuild instead of JetBrainsassist dotnet inspect [sln] --swea- Enable solution-wide error analysis (slower but more thorough)assist dotnet check-locks- Check if build output files are locked by a debuggerassist dotnet deps <csproj>- Show .csproj project dependency tree and solution membershipassist dotnet in-sln <csproj>- Check whether a .csproj is referenced by any .sln fileassist jira auth- Authenticate with Jira via API token (saves site/email to ~/.assist/jira.json)assist jira ac <issue-key>- Print acceptance criteria for a Jira issueassist jira view <issue-key>- Print the title and description of a Jira issueassist ravendb auth add- Add a new RavenDB connection (prompts for name, URL, database, op:// secret reference)assist ravendb auth list- List configured RavenDB connectionsassist ravendb auth remove <name>- Remove a configured connectionassist ravendb set-connection <name>- Set the default connection for query/collections commandsassist ravendb query [connection] [collection]- Query a RavenDB collection (outputs JSON to stdout)assist ravendb query [connection] [collection] --page-size <n> --sort <field> --query <lucene> --limit <n>- Query with optionsassist ravendb collections [connection]- List collections and document counts in a databaseassist seq auth add- Add a new Seq connection (prompts for name, URL, API token)assist seq auth list- List configured Seq connectionsassist seq auth remove <name>- Remove a configured connectionassist seq set-connection <name>- Set the default Seq connectionassist seq query <filter>- Query Seq events with a filter expressionassist seq query <filter> -c <connection>- Query using a specific connectionassist seq query <filter> --json- Output raw JSONassist seq query <filter> -n <count>- Fetch a specific number of events (default 50)assist screenshot <process>- Capture a screenshot of a running application window (e.g.assist screenshot notepad). Output directory is configurable viascreenshot.outputDir(default./screenshots)assist complexity <pattern>- Analyze a file (all metrics if single match, maintainability if multiple)assist complexity cyclomatic [pattern]- Calculate cyclomatic complexity per functionassist complexity halstead [pattern]- Calculate Halstead metrics per functionassist complexity maintainability [pattern]- Calculate maintainability index per fileassist complexity sloc [pattern]- Count source lines of code per fileassist transcript configure- Configure transcript directoriesassist transcript format- Convert VTT files to formatted markdown transcriptsassist transcript summarise- List transcripts that do not have summariesassist voice setup- Download required voice models (VAD, STT)assist voice start- Start the voice daemon (always-on, listens for wake word)assist voice start --foreground- Start in foreground for debuggingassist voice stop- Stop the voice daemonassist voice status- Check voice daemon status and recent eventsassist voice devices- List available audio input devicesassist voice logs [-n <count>]- Show recent voice daemon log entries
