Skip to main content

A CLI translating user requests into specific CLI commands

Project description

claix: Command Line AI eXpert

Transforming user instructions into CLI commands with the power of GPT-4, right in your terminal.

Key Features

  • AI-Powered Command Generation: Uses GPT-4 for interpreting and translating natural language instructions into CLI commands.
  • Integrated Terminal Workflow: Directly operates in the terminal for enhanced efficiency.
  • Automated Error Handling: Processes command execution errors and suggests alternative commands.
  • User Convenience: Eliminates the need for copy-pasting from web browsers.
  • Adaptive Solutions: Generates alternative commands based on the context of encountered errors.

Prerequisites

  • Python 3.10+
  • OPENAI_API_KEY environment variable set up

Installation

pip install --upgrade claix

Usage Examples

Task Instruction Output
Change file extensions claix change the extension of all files under images/ from .jpeg to .jpg find images/ -type f -name "*.jpeg" -exec sh -c 'x="{}"; mv "$x" "${x%.jpeg}.jpg"' \;
List Git branches claix list all git branches in order of creation git for-each-ref --sort=creatordate --format '%(refname:short)' refs/heads/
Find large files claix find all files larger than 10MB in this directory find . -type f -size +10M

Contributing

We welcome contributions to claix! Here's how you can contribute:

  • Fork the project.
  • Create a feature branch.
  • Commit your changes.
  • Push to the branch.
  • Open a pull request.

License

claix is released under the MIT License.

Contact

For queries or contributions, contact via email at facundogoiriz@gmail.com or on GitHub at fakamoto.

Future Plans

  • Enhanced UI.
  • Function calling capabilities.
  • Integration of external commands.
  • Adaptation of commands based on environmental data.

FAQs

Q: How accurate are the commands generated by claix?
A: claix uses a gpt-4o-mini powered assistant specialized in CLIs for high accuracy.

Q: Can it handle complex instructions?
A: Currently optimized for single-step commands, with plans to handle multi-step instructions in the future.

Q: What if claix doesn't understand my instruction?
A: Try rephrasing or simplifying. claix is continually improving in understanding various instructions.

Q: What are the limitations of claix's commands?
A: Best suited for Linux CLI commands; may not handle highly specialized or context-specific commands well.

Q: How does claix handle errors from executed commands?
A: It suggests alternative commands by analyzing the error context, reducing the need for manual intervention.

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

claix-0.1.6.tar.gz (7.8 kB view details)

Uploaded Source

Built Distribution

claix-0.1.6-py3-none-any.whl (8.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: claix-0.1.6.tar.gz
  • Upload date:
  • Size: 7.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.4 CPython/3.11.0 Linux/6.8.0-1015-azure

File hashes

Hashes for claix-0.1.6.tar.gz
Algorithm Hash digest
SHA256 9006ffda5f3d1f153c9c5db762f453070c6a5bc5977101077ce88b07f7b687b0
MD5 9ec5786a1bd5a65d3810097e20c73951
BLAKE2b-256 2818fb1a138a7ebecc72c2cb5d359837748b9377c88a8e10cce9399fe4aa3290

See more details on using hashes here.

File details

Details for the file claix-0.1.6-py3-none-any.whl.

File metadata

  • Download URL: claix-0.1.6-py3-none-any.whl
  • Upload date:
  • Size: 8.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.8.4 CPython/3.11.0 Linux/6.8.0-1015-azure

File hashes

Hashes for claix-0.1.6-py3-none-any.whl
Algorithm Hash digest
SHA256 e255ff903b06bf9442ad73c4fc9c1f653f643da55bc220d1b45d27fc9ed63812
MD5 2841fcfcb0ae1496c9a53b04e102b087
BLAKE2b-256 a2823ad0926d8c28df1083c322a42504a2b10660be9632fd7e96a267e8028e0c

See more details on using hashes here.

Supported by

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