Asem Sharif - Personal Toolkit

CLI to discover and run install/setup scripts from 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:

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

pip install asem-sharif

Usage

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

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