# aclip

`aclip` is the official short-name Python package for ACLIP.

It is published in lockstep with `rendo-aclip` and installs the same SDK release.

Use `aclip` if you want the shortest install command.
Use `rendo-aclip` if you want the canonical dependency name in project manifests.

## Install

Short-name install:

```bash
pip install aclip
```

Canonical install:

```bash
pip install rendo-aclip
```

Either way, the import path is:

```python
from aclip import AclipApp
```

## What ACLIP gives you

- natural CLI invocation
- progressive Markdown help
- structured result and error envelopes
- sidecar manifests for distribution metadata
- packaging helpers for shipping binary CLIs

## First Working CLI

```python
from aclip import AclipApp, cli_main


def create_app() -> AclipApp:
    app = AclipApp(
        name="notes",
        version="0.2.2",
        summary="A minimal notes CLI.",
        description="Create and list notes from a small local CLI.",
    )

    app.group(
        "note",
        summary="Manage notes",
        description="Create and inspect notes.",
    ).command(
        "create",
        summary="Create a note",
        examples=["notes note create --title hello --body world"],
        handler=lambda title, body: {"note": {"title": title, "body": body}},
    )

    return app


cli_main("notes_cli.app:create_app")
```

Typical usage:

```bash
notes --help
notes note --help
notes note create --help
notes note create --title hello --body world
```

Installing `aclip` installs `rendo-aclip==0.2.2`.
