6119
My
mysis / files
mysis / README.md
1.9 KB
1# Mysis 2 3A terminal companion for piloting a single AI agent through the SpaceMolt universe. 4 5## Overview 6 7Mysis is your personal mission control for commanding one AI spaceship captain in [SpaceMolt](https://www.spacemolt.com). Built with Go and Bubble Tea, it connects a single LLM-powered agent to the game via Model Context Protocol, letting you guide your captain through the cosmos with natural language commands. 8 9Where Zoea-Nova orchestrates swarms, Mysis focuses on the intimate bond between commander and captain. One agent, one mission, full control. 10 11## Features 12 13- **Single-Agent Focus**: Direct communication with your AI captain 14- **Terminal Interface**: Clean TUI built with Bubble Tea 15- **Flexible LLM Support**: Local Ollama or remote OpenCode Zen models 16- **MCP Integration**: Native SpaceMolt game connection via Model Context Protocol 17- **Real-time Interaction**: Watch your agent think, decide, and act 18 19## Requirements 20 21**Terminal:** 22 23- Minimum size: 80 columns × 20 lines 24- TrueColor support recommended (24-bit RGB) 25- Unicode font (Nerd Font or Unicode-compatible font) 26 27**Recommended Terminals:** 28 29- Alacritty, Kitty, WezTerm, Ghostty (best compatibility) 30- iTerm2 (macOS), Windows Terminal (with Nerd Font) 31 32## Try it 33 34```sh 35make run # Build and start 36make install # Install to ~/.config/mysis/bin/mysis 37./bin/mysis # Run directly 38 39or 40 41./bin/mysis -debug # With debug logging 42``` 43 44## CLI Flags 45 46- `--config <path>` - Path to config file (default: `./config.toml` or `~/.config/mysis/config.toml`) 47- `--debug` - Enable debug logging 48 49## Configuration 50 51Edit `config.toml` to configure: 52 53- LLM providers (Ollama, OpenCode Zen) 54- MCP upstream endpoint 55- Model selection and temperature 56 57See `config.toml` for details. 58 59## Technology Stack 60 61- **Language:** Go 1.24.2 62- **TUI:** Bubble Tea (charmbracelet/bubbletea) 63- **HTTP:** go-openai for OpenAI-compatible APIs 64- **Logging:** zerolog 65- **Config:** TOML 66 67## License 68 69See LICENSE file.