maa(1)

💅 maa(1) — like, the manual page for maa, bestie

okay so real talk: this is the maa(1) page from the General Commands Manual, and it's your little gateway to maa — which is, and I cannot stress this enough, a tool for Arknights. 🎀 That's the whole vibe. That's the whole NAME section. We love a concise queen.

---

✨ SYNOPSIS ✨

maa [--batch] [-v|--verbose]... [-q|--quiet]... [--log-file] [-h|--help]
[-V|--version] <subcommands>

like yes, that's a lot of brackets, don't panic 💖 — every one of those bad boys is explained below, and the <subcommands> at the end is where all the actual fun happens. iykyk.

---

🌸 DESCRIPTION 🌸

A tool for Arknights. 🦋

that's it. that's the description. she said what she said, periodt.

---

👑 OPTIONS 👑

• --batch — turns on batch mode. so here's the tea: if your task file has some input parameters in it, normally maa will hit you with prompts asking you to input stuff. in batch mode those prompts get skipped entirely, and the parameters just get set to their default values. no questions, no waiting, no talking. 💅
• -v, --verbose — cranks the verbosity up. repeat it for even more verbosity, because more is more, always. 🔥
• -q, --quiet — the opposite energy: decreases verbosity. repeat for more quiet. shhh. 🤫
• --log-file[=<PATH>] — redirects the log to a file instead of stderr. and if you don't specify a log file (i.e. no =<PATH>), the log gets written to $(maa dir log)/YYYY/MM/DD/HH:MM:SS.log — yes that's a real path with real date/time formatting in it, keep it exactly like that. 🗂️
• -h, --help — prints the help. pro tip from the original, not me: this one shows the full help, and you can get a summary with '-h'. 👀
• -V, --version — prints the version. iconic, brief, to the point. ⭐

---

🦋 SUBCOMMANDS 🦋

okay bestie, here's the whole roster — every single one, no skips, no cuts, we are thorough in this house 🌈:

• maa-hot-update(1) — hot update for resource. 🔥
• maa-dir(1) — print path of maa directories.
• maa-version(1) — print version of given component.
• maa-run(1) — run a custom task.
• maa-startup(1) — Startup Game and Enter Main Screen.
• maa-closedown(1) — close game client.
• maa-fight(1) — run fight task.
• maa-copilot(1) — run copilot task.
• maa-ssscopilot(1) — run SSSCopilot task.
• maa-paradoxcopilot(1) — run Paradox Simulation copilot task.
• maa-roguelike(1) — run rouge-like task. (spelled exactly like that in the original, bestie — do not come for me, I am merely the messenger 🙈)
• maa-reclamation(1) — run Reclamation Algorithm task.
• maa-convert(1) — convert file format between TOML, YAML and JSON.
• maa-activity(1) — show stage activity of given client.
• maa-remainder(1) — get the remainder of given divisor and current date.
• maa-cleanup(1) — Clearing the caches of maa-cli and maa core. 🧹
• maa-list(1) — list all available tasks.
• maa-import(1) — import configuration files from a local path or a remote URL.
• maa-init(1) — initialize configurations for maa-cli.
• maa-complete(1) — generate completion script for given shell.
• maa-mangen(1) — generate man page. (yes, the man page can generate man pages. she's self-sufficient like that. main character energy fr fr 👑)

lowkey go read the individual subcommand pages too — they're each their own whole thing and this page is just the group chat invite. 🫶

---

⭐ VERSION ⭐

v0.7.7 — that's the number, no cap. 💜

---

and that's the whole page!! 💖 big sign-off energy: this was maa(1) from the General Commands Manual, documenting maa 0.7.7 — so if your maa is not vibing at 0.7.7, check the matching man page, bestie. go slay some stages. 🦋✨🎀