xonecas.io
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.