# MAIASS

> MAIASS (Modular AI-Augmented Semantic Scribe) is a Git workflow CLI that automates commit messages, semantic versioning, changelog generation, and branch merging. Available as an npm package (`maiass`) and a Bash/Homebrew tool (`bashmaiass`).

MAIASS is used by running a single command (`maiass` or `nma`) inside any Git repository. It stages changes, generates an AI-powered commit message by analysing the diff, bumps the project version, updates the changelog, and merges through a configurable branch pipeline (feature → develop → staging → main). No registration is required — anonymous usage starts immediately with free AI credits on first install.

## Key concepts

- **AI commit messages**: MAIASS sends your staged diff to an OpenAI-compatible proxy and returns a structured, conventional-style commit message. The user can accept, edit, or reject it.
- **Anonymous subscriptions**: identified by machine fingerprint. No email or account required to start. Credits are deducted per token via an append-only ledger.
- **Credit-based billing**: pay-as-you-go AI credits. Free credits included on first run (~25 commits). Top up via the dashboard at maiass.net/pricing.
- **Semantic versioning**: detects and bumps version numbers in `package.json`, `composer.json`, `VERSION`, WordPress `style.css`, Swift `.pbxproj`, and custom text files.
- **Branch workflow**: automates the develop → staging → main merge pipeline with configurable branch names.
- **JIRA integration**: ticket numbers auto-detected from branch names and injected into commits.
- **Zero config**: works with sensible defaults. Customise via `.env.maiass` (project-level, committed) and `.env.maiass.local` (personal, gitignored).

## Installation

```bash
# Node.js (cross-platform, recommended for Windows)
npm install -g maiass

# Bash / macOS / Linux via Homebrew
brew tap vsmash/maiass && brew install maiass

# One-line curl installer
curl -sSL https://github.com/vsmash/maiass/releases/latest/download/install.sh | bash
```

## Basic usage

```bash
maiass              # stage, AI commit, bump patch version, merge pipeline
maiass minor        # bump minor version
maiass major        # bump major version
maiass --commits-only   # AI commit message only, skip versioning
maiass --dry-run    # preview without making changes
maiass --setup      # interactive project setup wizard
```

## Links

- [Homepage](https://maiass.net)
- [Pricing & credits](https://maiass.net/pricing)
- [npm package (maiass)](https://www.npmjs.com/package/maiass)
- [GitHub — Node.js CLI](https://github.com/vsmash/maiass)
- [GitHub — Bash CLI](https://github.com/vsmash/bashmaiass)
- [Homebrew tap](https://github.com/vsmash/homebrew-bashmaiass)

## Optional

- [Privacy policy](https://maiass.net/privacy)
- [Terms of service](https://maiass.net/terms)
- [GDPR](https://maiass.net/gdpr)