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

https://github.com/gurselcakar/arithmego

Arithmetic game for the terminal.
https://github.com/gurselcakar/arithmego

arithmetic bubble-tea cli developer-tools game go golang math terminal tui

Last synced: about 2 months ago
JSON representation

Arithmetic game for the terminal.

Awesome Lists containing this project

README

          

ArithmeGo

[![Build](https://img.shields.io/github/actions/workflow/status/gurselcakar/arithmego/ci.yml?branch=main)](https://github.com/gurselcakar/arithmego/actions)
[![Release](https://img.shields.io/github/v/release/gurselcakar/arithmego)](https://github.com/gurselcakar/arithmego/releases)
[![Downloads](https://img.shields.io/github/downloads/gurselcakar/arithmego/total)](https://github.com/gurselcakar/arithmego/releases)
[![License](https://img.shields.io/github/license/gurselcakar/arithmego)](LICENSE)

## Install

**macOS / Linux**
```bash
curl -fsSL https://arithmego.com/install.sh | bash
```

**Windows (PowerShell)**
```powershell
irm https://arithmego.com/install.ps1 | iex
```

## About

ArithmeGo is an arithmetic game that runs in your terminal.

AI agents are getting better at handling longer tasks. While they work,
you wait. ArithmeGo was built to fill that gap with something useful:
mental math practice, right where you already are.

It covers basic arithmetic, powers and roots, and advanced operations
like modulo and factorials. Five difficulty levels from beginner to
expert. Timed sprints with scoring and streaks, or untimed practice
at your own pace. All progress is tracked locally.

## Usage

```
arithmego # Open main menu
arithmego play # Browse and pick a game mode
arithmego practice # Start practice mode
arithmego statistics # View your stats
arithmego settings # Adjust your preferences
```

## Development

Requires Go 1.25+.

```
make build # Build for current platform
make run # Build and run
make test # Run tests
make lint # Run linter
```

## Docs

- [Architecture](docs/ARCHITECTURE.md) — Tech stack and project structure
- [Website](docs/WEBSITE.md) — Hugo site structure and content editing

## License

MIT. See [LICENSE](LICENSE).