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

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

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.6.tar.gz (53.1 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.6-py3-none-any.whl (6.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: autocmd_cli-0.1.6.tar.gz
  • Upload date:
  • Size: 53.1 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.6.tar.gz
Algorithm Hash digest
SHA256 6969b7c902c754d92ad5fd99c8d530d54ae06c4ddb30a9634327acc324d29ff3
MD5 73d0dd6895b57c08c6cb965e594274c8
BLAKE2b-256 48972fc8d0cb09482b45454df690e388c7ee43a37ab45a516430ca14d8b2e80a

See more details on using hashes here.

Provenance

The following attestation bundles were made for autocmd_cli-0.1.6.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.6-py3-none-any.whl.

File metadata

  • Download URL: autocmd_cli-0.1.6-py3-none-any.whl
  • Upload date:
  • Size: 6.0 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.6-py3-none-any.whl
Algorithm Hash digest
SHA256 a6564bb3f4a5f716acb9f54b811cb5056fde5fd8d0515e83e3b86dce9c03e4f6
MD5 9a7100da05b70f728d9446bc9906df78
BLAKE2b-256 97dd8df1aba06cbb137c726e045081d46e627042965db746debde28e4ec6ae56

See more details on using hashes here.

Provenance

The following attestation bundles were made for autocmd_cli-0.1.6-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