oomi-ai 0.1.0

package/README.md

@@ -0,0 +1,25 @@
+# oomi-ai
+
+CLI to install Oomi agent instructions into an OpenClaw workspace.
+
+## Install
+```
+npm install -g oomi-ai
+```
+
+## Usage
+```
+oomi init
+```
+
+Optional flags:
+```
+oomi init --workspace /path/to/openclaw/workspace
+oomi init --agents-file /path/to/AGENTS.md
+```
+
+By default, the CLI writes to:
+- `$OPENCLAW_WORKSPACE/AGENTS.md` (if set), otherwise
+- `~/.openclaw/workspace/AGENTS.md`
+
+Restart OpenClaw after running this command.

package/agent_instructions.md

@@ -0,0 +1,12 @@
+# Oomi Avatar Control
+
+Before using avatar commands, call `get_avatar_capabilities` and prefer canonical values.
+Inline tags are stripped from user-visible text.
+
+Use inline tags like:
+- [anim:Waving], [anim:Walking], [anim:Idle], [anim:Sitting Idle]
+- [face:happy], [face:sad], [face:surprised], [face:focused], [face:gentle], [face:thinking]
+- [gesture:nod], [gesture:think], [gesture:shrug], [gesture:wave], [gesture:bow]
+- [look:camera], [look:left], [look:right], [look:up], [look:down]
+
+Aliases allowed (if needed): wave -> Waving, walk -> Walking, idle -> Idle, sit/sitting -> Sitting Idle

package/bin/oomi-ai.js

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+
+const MARKER_START = '<oomi-agent-instructions>';
+const MARKER_END = '</oomi-agent-instructions>';
+
+function usage() {
+  console.log(`oomi init [--agents-file PATH] [--workspace PATH]
+
+Installs Oomi agent instructions into OpenClaw AGENTS.md.
+`);
+}
+
+function readFile(filePath) {
+  return fs.readFileSync(filePath, 'utf-8');
+}
+
+function writeFile(filePath, content) {
+  fs.writeFileSync(filePath, content);
+}
+
+function resolveWorkspace() {
+  const envWorkspace = process.env.OPENCLAW_WORKSPACE || process.env.OPENCLAW_HOME;
+  if (envWorkspace) return envWorkspace;
+  return path.join(os.homedir(), '.openclaw', 'workspace');
+}
+
+function resolveAgentsFile(cliAgentsFile, cliWorkspace) {
+  if (cliAgentsFile) return cliAgentsFile;
+  const workspace = cliWorkspace || resolveWorkspace();
+  return path.join(workspace, 'AGENTS.md');
+}
+
+function resolveInstructionsFile() {
+  return path.join(path.dirname(new URL(import.meta.url).pathname), '..', 'agent_instructions.md');
+}
+
+function installBlock(agentsPath, block) {
+  let existing = '';
+  if (fs.existsSync(agentsPath)) {
+    existing = readFile(agentsPath);
+  }
+
+  let content = '';
+  if (existing.includes(MARKER_START) && existing.includes(MARKER_END)) {
+    const pre = existing.split(MARKER_START)[0];
+    const post = existing.split(MARKER_END)[1];
+    content = `${pre}${block}${post}`;
+  } else {
+    const spacer = existing && !existing.endsWith('\n\n') ? '\n\n' : '';
+    content = `${existing}${spacer}${block}\n`;
+  }
+
+  writeFile(agentsPath, content);
+}
+
+function parseArgs(argv) {
+  const args = { command: null, agentsFile: null, workspace: null };
+  const rest = argv.slice(2);
+  if (rest.length > 0) {
+    args.command = rest[0];
+  }
+  for (let i = 1; i < rest.length; i += 1) {
+    const val = rest[i];
+    if (val === '--agents-file') {
+      args.agentsFile = rest[i + 1];
+      i += 1;
+    } else if (val === '--workspace') {
+      args.workspace = rest[i + 1];
+      i += 1;
+    } else if (val === '--help' || val === '-h') {
+      usage();
+      process.exit(0);
+    }
+  }
+  return args;
+}
+
+function main() {
+  const args = parseArgs(process.argv);
+  if (!args.command || args.command === 'help' || args.command === '--help') {
+    usage();
+    process.exit(0);
+  }
+
+  if (args.command !== 'init') {
+    console.error(`Unknown command: ${args.command}`);
+    usage();
+    process.exit(1);
+  }
+
+  const agentsPath = resolveAgentsFile(args.agentsFile, args.workspace);
+  const instructionsPath = resolveInstructionsFile();
+
+  if (!fs.existsSync(instructionsPath)) {
+    console.error('Agent instructions file not found in package.');
+    process.exit(1);
+  }
+
+  const instructions = readFile(instructionsPath).trim();
+  const block = `${MARKER_START}\n${instructions}\n${MARKER_END}`;
+
+  const dir = path.dirname(agentsPath);
+  if (!fs.existsSync(dir)) {
+    fs.mkdirSync(dir, { recursive: true });
+  }
+
+  installBlock(agentsPath, block);
+  console.log(`Installed Oomi agent instructions into ${agentsPath}`);
+  console.log('Restart OpenClaw to pick up changes.');
+}
+
+main();

package/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "oomi-ai",
+  "version": "0.1.0",
+  "description": "Oomi CLI for OpenClaw setup",
+  "bin": {
+    "oomi": "bin/oomi-ai.js"
+  },
+  "type": "module",
+  "license": "MIT",
+  "files": [
+    "bin/oomi-ai.js",
+    "agent_instructions.md",
+    "README.md"
+  ]
+}