Guides adding and extending amy CLI subcommands in the Amethyst Kotlin codebase.
npx skills add https://github.com/vitorpamplona/amethyst --skill amy-expert
Please help me install this Agent Skill. Skill: amy-expert Source: https://github.com/vitorpamplona/amethyst/tree/main/.claude/skills/amy-expert Command: npx skills add https://github.com/vitorpamplona/amethyst --skill amy-expert
Extending the amy CLI in the Amethyst repository requires following strict architectural rules: the cli/ module must stay a thin assembly layer, output must follow a dual text/JSON contract, and business logic must live in commons/ or quartz/. This Skill encodes those rules so new commands are added without breaking the CLI's public API or interop test harnesses.
amy note publish command, use this Skill to place the event-building logic in commons/, write the command file from the template, wire it into Main.kt, and emit results via Output.emit with the correct JSON shape.Use the amy-expert skill to add a new amy subcommand that publishes a text note, following the command template and wiring it into Main.kt.
High-intent search queries and answers about installing and using this skill.
Create a command file under cli/commands/ using the standard object pattern, add a branch in Main.kt's dispatch, extend printUsage(), and add a row to cli/README.md's command table. Multi-verb groups use the shared route() helper in Router.kt.
Business logic belongs in commons/ and protocol logic in quartz/, never in cli/. If the logic only exists in amethyst/ with Android dependencies, extract it to commons/ first using the extraction recipe, then add the CLI command in a separate commit.
amy emits human-readable text on stdout by default and a single-line JSON object under the --json flag, with stable snake_case keys. Errors go to stderr, and exit codes are 0 for success, 1 for runtime errors, 2 for bad arguments, and 124 for await timeouts.
List the Android-only dependencies such as Context, SharedPreferences, or WorkManager, then inline, abstract via expect/actual, or invert them as constructor arguments. Move the file to commons/commonMain, update the Android caller, and add a JVM test before writing the command.
Commands must emit results through Output.emit and Output.error so the text/JSON mode branching works correctly, and they are suspend functions because main() already handles runBlocking. Direct println breaks the dual-output contract that interop harnesses depend on.
fsalesImplement Nostr protocol events with Quartz patterns for Kotlin Multiplatform.
ComposioHQWrite and debug Docker-based end-to-end tests for the Composio CLI binary.
ImL1sConfigure Kotlin Multiplatform source sets with expect/actual patterns.
shift-editorWrite Shift tests that assert on user-observable state instead of mock invocation details.