https://github.com/wenyuzhao/autosh
The AI-powered, noob-friendly interactive shell.
https://github.com/wenyuzhao/autosh
ai chatgpt gpt shell terminal
Last synced: about 2 months ago
JSON representation
The AI-powered, noob-friendly interactive shell.
- Host: GitHub
- URL: https://github.com/wenyuzhao/autosh
- Owner: wenyuzhao
- License: mit
- Created: 2024-02-16T13:30:40.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2025-04-26T04:04:54.000Z (about 1 year ago)
- Last Synced: 2026-01-14T00:57:57.690Z (6 months ago)
- Topics: ai, chatgpt, gpt, shell, terminal
- Language: Python
- Homepage:
- Size: 4.41 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# `autosh` - The AI-powered, noob-friendly interactive shell
# Getting Started
## Install
```bash
uv tool install autosh
```
## Usage
As an interactive shell: `ash` (alternatively, `autosh`)
Execute a single prompt: `ash "list current directory"`
Process piped data:
* `cat README.md | ash -y "summarize"`
* `cat in.csv | ash -y -q "double the first numeric column" > out.csv`
## Scripting
Write AI-powered shell scripts in Markdown using natural language!
Example script ([simple.a.md](examples/simple.a.md)):
```markdown
#!/usr/bin/env ash
# This is a simple file manipulation script
First, please display a welcome message:)
Write "Hello, world" to _test.log
```
* Run the script: `ash simple.a.md` or `chmod +x simple.a.md && ./simple.a.md`
* Auto-generate help messages:
```console
$ ash simple.a.md -h
Usage: simple.a.md [OPTIONS]
This is a simple file manipulation script that writes "Hello, world" to a log file named _test.log.
Options:
• -h, --help Show this message and exit.
```
## Plugins
`autosh` comes with several plugins to expand its capabilities:
* `ash "Create a directory 'my-news', list the latest news, and for each news item, put the summary in a separate markdown file in this directory"`
# TODO
- [ ] Image input, generation, and editing
- [ ] RAG for non-text files
- [ ] Plugin system
- [ ] MCP support
- [x] Improved input widget with history and auto-completion