Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/jedahan/kiss-find

search across all kiss repositories
https://github.com/jedahan/kiss-find

kiss

Last synced: 3 months ago
JSON representation

search across all kiss repositories

Lists

README

        

# kiss-find

commandline tool for indexing and searching as many kiss repositories as possible

web version up on https://jedahan.com/kiss-find

database updates every 6 hours

![web client](screenshot.png)

build and index a new db

make

install kiss-find and db

make install

try out kiss-find

$ kiss find amf
amfora 1.7.2 2 https://github.com/jedahan/kiss-repo amfora a fancy terminal browser for the gemini protocol
amfora 1.8.0 1 https://github.com/aabacchus/kiss-repo amfora a fancy terminal browser for the gemini protocol
bamf 0.5.4 1 https://github.com/eudaldgr/elementaKISS extra/bamf
tinyramfs git 1 https://github.com/mmatongo/dm kernel/tinyramfs

# contributing

This project uses [git bug][], a distributed bug-tracker that integrates with the git repository, to manage issues, features, etc.

For folks who are more comfortable with the web you may use the [github issue tracker][].

# client

You can install kiss-find on kiss with the package in this repo.

make install-cli
> cd dist/kiss/kiss-find
> kiss build && kiss install
kiss find amf

# build

This repository contains the tools used to create the kiss-find database and web client.

The database build requires `git` and `grep`

Optional support for github repo discovery is enabled by being logged in with the github `gh` cli, and requires `jq`.

Run `make clean; make` to generate a fresh db for kiss-find.

The web client build requires `tjs`

# adding a repository

If your repository is on github, just add the `kiss-repo` [topic][] and it should be automatically picked up.

If your repository is anywhere else, [open a pull request][] adding it to the `include` file.

# removing a repository

If you would not like your repository indexed, [request removal][] and we will add it the `filter` file.

# credits

Created by [@admicos](https://ecmelberk.com), rewritten and maintained by [@jedahan](https://github.com/jedahan)

[git bug]: https://github.com/MichaelMure/git-bug
[github issue tracker]: https://github.com/jedahan/kiss-find/issues
[open a pull request]: https://github.com/jedahan/kiss-find/edit/main/include
[request a removal]: https://github.com/jedahan/kiss-find/issues/new?assignees=jedahan&labels=filter&template=remove-repository-request.md&title=Remove+repository+http%3A%2F%2Fgithub.com%2Fperson%2Fkiss-repo.git
[the `filter` file]: https://github.com/jedahan/kiss-find/blob/main/filter
[the `include` file]: https://github.com/jedahan/kiss-find/blob/main/include