https://github.com/tamnd/mathse-cli
Search Math Stack Exchange questions, answers, and tags as structured records from the terminal.
https://github.com/tamnd/mathse-cli
cli golang json math-stackexchange mathematics scraper stackexchange
Last synced: 1 day ago
JSON representation
Search Math Stack Exchange questions, answers, and tags as structured records from the terminal.
- Host: GitHub
- URL: https://github.com/tamnd/mathse-cli
- Owner: tamnd
- License: apache-2.0
- Created: 2026-06-13T20:07:28.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-06-29T12:28:29.000Z (16 days ago)
- Last Synced: 2026-06-29T14:24:59.317Z (16 days ago)
- Topics: cli, golang, json, math-stackexchange, mathematics, scraper, stackexchange
- Language: Go
- Size: 40 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# mathse
Search Math Stack Exchange questions
`mathse` is a single pure-Go binary. It speaks to mathse over plain
HTTPS, shapes the responses into clean records, and pipes into the rest of your
tools. No API key, nothing to run alongside it.
## Install
```bash
go install github.com/tamnd/mathse-cli/cmd/mathse@latest
```
Or grab a prebuilt binary from the [releases](https://github.com/tamnd/mathse-cli/releases), or run
the container image:
```bash
docker run --rm ghcr.io/tamnd/mathse:latest --help
```
## Usage
```bash
mathse --help
mathse version
```
This is a fresh scaffold. The command tree starts with `version`; build out the
real commands in `cli/` on top of the `mathse` library package.
## Development
```
cmd/mathse/ thin main, wires cli.Root into fang
cli/ the cobra command tree
mathse/ the library: HTTP client and data models
docs/ tago documentation site
```
```bash
make build # ./bin/mathse
make test # go test ./...
make vet # go vet ./...
```
## Releasing
Push a version tag and GitHub Actions runs GoReleaser, which builds the
archives, Linux packages, the multi-arch GHCR image, checksums, SBOMs, and a
cosign signature:
```bash
git tag v0.1.0
git push --tags
```
The Homebrew and Scoop steps self-disable until their tokens exist, so the first
release works with no extra secrets.
## License
Apache-2.0. See [LICENSE](LICENSE).