Skip to main content

Natural language to shell command.

Project description

autocmd

Natural language to shell command.

Installation

# Install from PyPI (recommended)
uv tool install autocmd-cli

# Or directly from git
uv tool install git+https://github.com/dvirzg/autocmd.git

Quick start

The first time you run autocmd, it will:

  1. Ask for your Anthropic API key – saved to ~/.config/autocmd/config.
  2. Offer shell integration (recommended) – adds a small wrapper to .zshrc/.bashrc so commands appear on your prompt, ready to edit before running.

Trigger setup with any command:

autocmd "check git status"

After setup:

autocmd "git fetch all updates from remote"
# → git fetch --all  (lands on your prompt, you hit Enter or edit)

More examples:

autocmd "show git log for last 5 commits"
autocmd "find all python files modified today"
autocmd "kill process on port 3000"

Configuration

Settings

Configure autocmd behavior with:

autocmd --settings

This allows you to:

  • Toggle streaming output on/off (default: on)

Model selection

By default autocmd uses claude-haiku-4-5-20251001. To change it, set AUTOCMD_MODEL:

# One-time use
AUTOCMD_MODEL=claude-sonnet-4-20250514 autocmd "your command here"

# In your shell config (~/.zshrc or ~/.bashrc)
export AUTOCMD_MODEL=claude-sonnet-4-20250514

Reset configuration

To reset all settings and API key:

autocmd --reset

Development

git clone https://github.com/dvirzg/autocmd.git
cd autocmd
./dev-setup.sh
source ~/.zshrc  # or ~/.bashrc

# Always uses the local code
autocmd-dev "check git status"

Uninstall

uv tool uninstall autocmd

Then remove the autocmd line from your shell config if you want to fully clean it up.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

autocmd_cli-0.1.7.tar.gz (53.8 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

autocmd_cli-0.1.7-py3-none-any.whl (6.7 kB view details)

Uploaded Python 3

File details

Details for the file autocmd_cli-0.1.7.tar.gz.

File metadata

  • Download URL: autocmd_cli-0.1.7.tar.gz
  • Upload date:
  • Size: 53.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for autocmd_cli-0.1.7.tar.gz
Algorithm Hash digest
SHA256 6538149cf1acd0a9f5c784d630a2363b1d98ff5eba1e07190f7cea2eba46b383
MD5 18d4b7df5367ee480b2a7584b4a1a634
BLAKE2b-256 fce889e4c5c20d8a749a23a4359382b941126b69037cf83781689ab237e77063

See more details on using hashes here.

Provenance

The following attestation bundles were made for autocmd_cli-0.1.7.tar.gz:

Publisher: publish.yml on dvirzg/autocmd

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file autocmd_cli-0.1.7-py3-none-any.whl.

File metadata

  • Download URL: autocmd_cli-0.1.7-py3-none-any.whl
  • Upload date:
  • Size: 6.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for autocmd_cli-0.1.7-py3-none-any.whl
Algorithm Hash digest
SHA256 1697f228c60d6d7bdeb48a76d70bd90feca3b5011225ec79997d7cfbca710ccc
MD5 f9afceeec3f772236cfcf6625c04ef3c
BLAKE2b-256 b083aa7cf3ebd7119438b1d99ccd653a71abfa62dd9c49092a5e10a6e498af79

See more details on using hashes here.

Provenance

The following attestation bundles were made for autocmd_cli-0.1.7-py3-none-any.whl:

Publisher: publish.yml on dvirzg/autocmd

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page