Metadata-Version: 2.5
Name: asem-sharif
Version: 0.1.0
Summary: CLI to discover and run install/setup scripts from asem-sharif-ai's GitHub repos
Project-URL: Homepage, https://asem-sharif-ai.pages.dev
Project-URL: Repository, https://github.com/asem-sharif-ai
Author: Asem Sharif
License: MIT
License-File: LICENSE
Requires-Python: >=3.11
Requires-Dist: click>=8.1
Requires-Dist: requests>=2.31
Requires-Dist: tomli>=2.0; python_version < '3.11'
Description-Content-Type: text/markdown

# Asem Sharif - Personal Toolkit

CLI to discover and run install/setup scripts from [asem-sharif-ai](https://github.com/asem-sharif-ai)'s
GitHub repos, without publishing full project source to PyPI.

Any repo can opt in by adding a `.asem/` marker directory:

```
project/
└── .asem/
    ├── tool.toml       # summary, entry, script, filters
    └── install.py      # or setup.sh | whichever tool.toml.entry names
```

`tool.toml` schema:

```toml
summary = "One-line description of the tool"
entry = "install.py"                         # or "setup.sh"
script = "Plain-language summary of what running entry actually does"
filters = ["tag-one", "tag-two"]             # optional, for `filter`
```

## Install

```bash
pip install asem-sharif
```

## Usage

```bash
asem sync                    # scan GitHub for repos with .asem/tool.toml
asem index                   # list all discovered tools
asem search <kw>             # search name + summary (--name-only / --summary-only)
asem filter <kw>             # search the filters/tags list
asem define <name>           # show url/summary/entry for one tool
asem readme <name>           # fetch that repo's README.md live
asem script <name>           # show what `run` would actually do
asem get <name> [path]       # git clone the full repo (default: ./<repo-name>/)
asem run <path>              # run .asem/install.py or setup.sh found under path
asem cache show|clear        # inspect/reset the local cache
asem visit                   # open the portfolio site (aliases: portfolio, website)
```

## Example

```bash
asem sync
asem search lynx
asem define lynx
asem script lynx
asem get lynx ~/projects/lynx
asem run ~/projects/lynx
```
