ionem

Library for building Ion binary skills with standard self-management commands.

Binary skills built for the Ion ecosystem implement a standard self subcommand group:

• <binary> self skill — print the embedded SKILL.md to stdout
• <binary> self info — show version, build target, and executable path
• <binary> self check — check if a newer version is available
• <binary> self update — download and install a newer version

ionem provides build-time SKILL.md preparation and runtime self-management via SelfManager.

Quick start

build.rs

For a plain SKILL.md (no templating):

fn main() {
    ionem::build::emit_target();
    ionem::build::copy_skill_md();
}

For a SKILL.md with variable substitution ({version}, {name}, {description} are auto-populated from Cargo metadata):

fn main() {
    ionem::build::emit_target();
    ionem::build::render_skill_md_vars(&[("author", "Alice")]);
}

For full control with your own template engine:

fn main() {
    ionem::build::emit_target();
    ionem::build::render_skill_md(|template| {
        my_engine::render(template, &context)
    });
}

src/main.rs

use ionem::self_update::SelfManager;

const SKILL_MD: &str = include_str!(concat!(env!("OUT_DIR"), "/SKILL.md"));

let manager = SelfManager::new(
    "owner/my-tool",
    "my-tool",
    "v",
    env!("CARGO_PKG_VERSION"),
    env!("TARGET"),
);

// In your clap match:
// SelfCommands::Skill  => print!("{}", SKILL_MD),
// SelfCommands::Info   => manager.print_info(),
// SelfCommands::Check  => manager.print_check()?,
// SelfCommands::Update => manager.run_update(version.as_deref())?,

Name

Latin ionem (accusative of ion) — ionizing a markdown skill into a binary executable.