| Name | shell-aider JSON |
| Version |
0.1.1
JSON |
| download |
| home_page | None |
| Summary | AI-powered shell assistant that uses tmux |
| upload_time | 2024-11-05 01:35:11 |
| maintainer | None |
| docs_url | None |
| author | None |
| requires_python | >=3.8 |
| license | GPLv3 |
| keywords |
ai
shell
tmux
assistant
terminal
|
| VCS |
 |
| bugtrack_url |
|
| requirements |
No requirements were recorded.
|
| Travis-CI |
No Travis.
|
| coveralls test coverage |
No coveralls.
|
# Shell aider
A command-line tool that works with your tmux scrollback. It reads your tmux pane content and provides contextually aware command suggestions using various AI models through litellm.
## Features
- Reads your tmux pane content and sends it to your choice of AI model
- Automatically parses commands from AI responses and puts them into your prompt
- Optional Stack Exchange integration to provide additional context from relevant stack exchange google search.
- Terrible and poorly thought out features like auto-execution and recursive mode for automated system destruction.
## Prerequisites
- Python 3
- TMux
- litellm
- BeautifulSoup4 (for Stack Exchange integration)
- requests
## Installation
1. Install required Python packages:
```bash
pip install shell-aider
```
2. Set up your API key for your chosen provider as an environment variable:
The tool looks for API keys in environment variables based on the chosen model:
```bash
# Example API key setup
export OPENROUTER_API_KEY="your-key-here"
export ANTHROPIC_API_KEY="your-key-here"
export GEMINI_API_KEY="your-key-here"
export TOGETHER_API_KEY="your-key-here"
```
- And any others supported by litellm
## Usage
Basic usage:
```bash
aider [options] [input]
```
### Options
- `-A`, `--auto`: Automatically execute the suggested command (use with caution)
- `-r`, `--recursive`: Add `;aider` to the end of suggested commands for continuous operation
- `-m MODEL`, `--model MODEL`: Choose AI model (Can select by shorthand for some models eg.'cs' for claude-3-5-sonnet-latest or 'gf' for gemini/gemini-1.5-flash-latest )
- `-q`, `--quiet`: Only output the command without explanation
- `-v`, `--verbose`: Enable verbose mode with detailed output
- `--debug`: Run in debug mode (skips API request)
- `-t TARGET`, `--target TARGET`: Specify target TMux pane (default: current pane)
- `--log FILE`: Log all output to specified file
- `--log-commands FILE`: Log only commands to specified file
- `--file FILE`: Read additional input from specified file
- `-S LINES`, `--scrollback LINES`: Number of scrollback lines to include from tmux (default: 0)
- `--system-prompt FILE`: Use custom system prompt from file
- `--delay SECONDS`: Set delay before auto-execution (default: 2.0 seconds)
- `-c`, `--add-stackexchange`: Add relevant context from Stack Exchange
- `-M MODEL`, `--model-stackexchange MODEL`: Specify model for Stack Exchange search query generation (default: gemini/gemini-1.5-flash-latest)
### Examples
1. Basic command suggestion based on visible terminal content:
```bash
aider
```
2. Get a suggestion for a specific task:
```bash
aider how to find large files
```
3. Use a specific model by number or name:
```bash
aider -m cs how do I automate these commands
# or
aider -m anthropic/claude-3-5-sonnet-latest how do I automate these commands
```
4. Include Stack Exchange context with custom model:
```bash
aider -c -M gemini/gemini-1.5-pro-latest how to compress images in bulk
```
5. Auto-execute commands with auto and recursive mode(or don't):
```bash
aider -A -r process these files # DO NOT DO THIS
```
6. Include more context from terminal history:
```bash
aider -S 100 why won't this compile
```
## Security Considerations
- **Review commands before execution**: Always review suggested commands before running them
- **Auto-execution risks**: The `-A` flag will execute commands without confirmation
- **Data privacy**: Be mindful that terminal content is sent to AI providers
- **API credentials**: Secure your API keys and avoid exposing them in scripts or logs
- **Recursive mode**: Use `-r` flag with extreme caution as it can create command loops
## Troubleshooting
- Enable verbose mode (-v) for detailed operation information
- Check API key environment variables if model requests fail
## Contributing
Contributions are welcome! Please feel free to submit issues and enhancement requests.
## License
GPL 3
Raw data
{
"_id": null,
"home_page": null,
"name": "shell-aider",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.8",
"maintainer_email": null,
"keywords": "ai, shell, tmux, assistant, terminal",
"author": null,
"author_email": "Elijah Knaperek <elijahknaperek@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/88/78/acc61d1689f6795266f3c0db63b7d5763319d615f58652dedcd379ec734a/shell_aider-0.1.1.tar.gz",
"platform": null,
"description": "# Shell aider\n\nA command-line tool that works with your tmux scrollback. It reads your tmux pane content and provides contextually aware command suggestions using various AI models through litellm.\n\n## Features\n\n- Reads your tmux pane content and sends it to your choice of AI model\n- Automatically parses commands from AI responses and puts them into your prompt\n- Optional Stack Exchange integration to provide additional context from relevant stack exchange google search.\n- Terrible and poorly thought out features like auto-execution and recursive mode for automated system destruction.\n\n## Prerequisites\n\n- Python 3\n- TMux\n- litellm\n- BeautifulSoup4 (for Stack Exchange integration)\n- requests\n\n## Installation\n\n1. Install required Python packages:\n ```bash\n pip install shell-aider\n ```\n2. Set up your API key for your chosen provider as an environment variable:\n The tool looks for API keys in environment variables based on the chosen model:\n ```bash\n # Example API key setup\n export OPENROUTER_API_KEY=\"your-key-here\"\n export ANTHROPIC_API_KEY=\"your-key-here\"\n export GEMINI_API_KEY=\"your-key-here\"\n export TOGETHER_API_KEY=\"your-key-here\"\n ```\n - And any others supported by litellm\n\n## Usage\n\nBasic usage:\n```bash\naider [options] [input]\n```\n\n### Options\n\n- `-A`, `--auto`: Automatically execute the suggested command (use with caution)\n- `-r`, `--recursive`: Add `;aider` to the end of suggested commands for continuous operation\n- `-m MODEL`, `--model MODEL`: Choose AI model (Can select by shorthand for some models eg.'cs' for claude-3-5-sonnet-latest or 'gf' for gemini/gemini-1.5-flash-latest )\n- `-q`, `--quiet`: Only output the command without explanation\n- `-v`, `--verbose`: Enable verbose mode with detailed output\n- `--debug`: Run in debug mode (skips API request)\n- `-t TARGET`, `--target TARGET`: Specify target TMux pane (default: current pane)\n- `--log FILE`: Log all output to specified file\n- `--log-commands FILE`: Log only commands to specified file\n- `--file FILE`: Read additional input from specified file\n- `-S LINES`, `--scrollback LINES`: Number of scrollback lines to include from tmux (default: 0)\n- `--system-prompt FILE`: Use custom system prompt from file\n- `--delay SECONDS`: Set delay before auto-execution (default: 2.0 seconds)\n- `-c`, `--add-stackexchange`: Add relevant context from Stack Exchange\n- `-M MODEL`, `--model-stackexchange MODEL`: Specify model for Stack Exchange search query generation (default: gemini/gemini-1.5-flash-latest)\n\n### Examples\n\n1. Basic command suggestion based on visible terminal content:\n ```bash\n aider\n ```\n\n2. Get a suggestion for a specific task:\n ```bash\n aider how to find large files\n ```\n\n3. Use a specific model by number or name:\n ```bash\n aider -m cs how do I automate these commands\n # or\n aider -m anthropic/claude-3-5-sonnet-latest how do I automate these commands\n ```\n\n4. Include Stack Exchange context with custom model:\n ```bash\n aider -c -M gemini/gemini-1.5-pro-latest how to compress images in bulk\n ```\n\n5. Auto-execute commands with auto and recursive mode(or don't):\n ```bash\n aider -A -r process these files # DO NOT DO THIS\n ```\n\n6. Include more context from terminal history:\n ```bash\n aider -S 100 why won't this compile\n ```\n\n## Security Considerations\n\n- **Review commands before execution**: Always review suggested commands before running them\n- **Auto-execution risks**: The `-A` flag will execute commands without confirmation\n- **Data privacy**: Be mindful that terminal content is sent to AI providers\n- **API credentials**: Secure your API keys and avoid exposing them in scripts or logs\n- **Recursive mode**: Use `-r` flag with extreme caution as it can create command loops\n\n## Troubleshooting\n\n- Enable verbose mode (-v) for detailed operation information\n- Check API key environment variables if model requests fail\n\n## Contributing\n\nContributions are welcome! Please feel free to submit issues and enhancement requests.\n\n## License\n\nGPL 3\n",
"bugtrack_url": null,
"license": "GPLv3",
"summary": "AI-powered shell assistant that uses tmux",
"version": "0.1.1",
"project_urls": {
"Homepage": "https://github.com/elijahknaperek/shell-aider"
},
"split_keywords": [
"ai",
" shell",
" tmux",
" assistant",
" terminal"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "20a46861fe887f5459c3ef56e159e618b60751d9c55c4ba6fe0e0372315643d7",
"md5": "6ca978f58eda128575ea8a91a58bd484",
"sha256": "b80abfe4191e908f7e956636b622cc0585a7e0719f55d471134e1b355c18115e"
},
"downloads": -1,
"filename": "shell_aider-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6ca978f58eda128575ea8a91a58bd484",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8",
"size": 20499,
"upload_time": "2024-11-05T01:35:10",
"upload_time_iso_8601": "2024-11-05T01:35:10.386373Z",
"url": "https://files.pythonhosted.org/packages/20/a4/6861fe887f5459c3ef56e159e618b60751d9c55c4ba6fe0e0372315643d7/shell_aider-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "8878acc61d1689f6795266f3c0db63b7d5763319d615f58652dedcd379ec734a",
"md5": "61a8aac651707dd76b8995b9ec2e222e",
"sha256": "a2818ece70acd3e0a22b6d25737a2d833440bf8f9d739cded534c028487cd1b8"
},
"downloads": -1,
"filename": "shell_aider-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "61a8aac651707dd76b8995b9ec2e222e",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8",
"size": 20110,
"upload_time": "2024-11-05T01:35:11",
"upload_time_iso_8601": "2024-11-05T01:35:11.865745Z",
"url": "https://files.pythonhosted.org/packages/88/78/acc61d1689f6795266f3c0db63b7d5763319d615f58652dedcd379ec734a/shell_aider-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-05 01:35:11",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "elijahknaperek",
"github_project": "shell-aider",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "shell-aider"
}
