Metadata-Version: 2.4
Name: autosh
Version: 0.0.2
Summary: Add your description here
License-File: LICENSE
Requires-Python: >=3.13
Requires-Dist: agentia>=0.0.5
Requires-Dist: asyncio>=3.4.3
Requires-Dist: markdownify>=1.1.0
Requires-Dist: pydantic>=2.11.3
Requires-Dist: python-dotenv>=1.1.0
Requires-Dist: rich>=14.0.0
Requires-Dist: tavily-python>=0.5.4
Requires-Dist: typer>=0.12.5
Requires-Dist: tzlocal>=5.3.1
Description-Content-Type: text/markdown

# `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 "summarise"`

## 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 _x.log.

    Options:

    • -h, --help     Show this message and exit.
    ```

## Plugins

`autosh` is equipped with several plugins to expand its potential:

* `ash "Create a directory "my-news", list the latest news, for each news, put the summary in a separate markdown file in this directory"`

# TODO

- [ ] Image generation
- [ ] Image input
- [ ] RAG for non-text files
