@ariso-ai/ari-hooks 0.1.0 → 0.1.2

package/README.md

@@ -2,7 +2,9 @@
 
 Shares your Claude Code activity with [Ari](https://ariso.ai): after every
 Claude Code turn, the hooks send your request and the final outcome (not the
-intermediate steps) to Ari.
+intermediate steps) to Ari. When a session starts, Ari suggests the top
+things Claude can take care of for you right now — pick one and Claude runs
+it.
 
 ## Install
 
@@ -15,14 +17,16 @@ npm install -g ari-hooks
 In any project folder where you use Claude Code:
 
 ```bash
-ari-hooks
+ari-hooks install
 ```
 
 That single command:
 
 1. Opens your browser to log in to Ari and mint an API token (stored in
    `~/.ari-hooks/config.json`, `0600`). Only needed once per machine.
-2. Adds two hooks to `./.claude/settings.json`:
+2. Adds three hooks to `./.claude/settings.json`:
+   - `SessionStart` — fetches Ari's top suggested tasks and shows them when
+     Claude Code boots; reply with a task number or name to run one
    - `UserPromptSubmit` — records what you asked for
    - `Stop` — reads the final assistant message from the transcript and sends
      the request/outcome pair to the Ari API
@@ -33,9 +37,9 @@ Existing settings and hooks are preserved; running it again is a no-op.
 
 | Command | What it does |
 |---|---|
-| `ari-hooks` | Login (if needed) + set up hooks in the current folder |
+| `ari-hooks install` | Login (if needed) + set up hooks in the current folder |
 | `ari-hooks login` | Browser login, stores the API token |
-| `ari-hooks init` | Just add the hooks to `./.claude/settings.json` |
+| `ari-hooks init` | Just add the hooks to `./.claude/settings.json` (no login) |
 | `ari-hooks config` | Show configured URLs and login state |
 | `ari-hooks status` | Show login state |
 | `ari-hooks logout` | Delete the stored token |
@@ -44,8 +48,7 @@ Existing settings and hooks are preserved; running it again is a no-op.
 
 By default the CLI talks to production (`https://web.ari.ariso.ai` /
 `https://api.ari.ariso.ai`). To test against a local Ari stack, persist
-overrides with the URL flags (they work on any command, including bare
-`ari-hooks`):
+overrides with the URL flags (they work on any command):
 
 ```bash
 ari-hooks config --web-url http://localhost:5173 --api-url http://localhost:4000

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ariso-ai/ari-hooks",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Set up Claude Code hooks that share your requests and their outcomes with Ari",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -6,9 +6,9 @@ import { loadConfig, setUrls, showConfig } from './config.js';
 const USAGE = `ari-hooks — share your Claude Code activity with Ari
 
 Usage:
-  ari-hooks              Log in (if needed) and set up hooks in the current folder
+  ari-hooks install      Log in (if needed) and set up hooks in the current folder
   ari-hooks login        Log in via the browser and store an API token
-  ari-hooks init         Add the hooks to ./.claude/settings.json
+  ari-hooks init         Just add the hooks to ./.claude/settings.json (no login)
   ari-hooks config       Show the configured URLs and login state
   ari-hooks status       Show login state
   ari-hooks logout       Remove the stored token
@@ -63,22 +63,26 @@ export async function main(argv) {
     case 'config':
       showConfig();
       return;
+    case 'install': {
+      if (!loadConfig().token) {
+        await login();
+      }
+      init();
+      return;
+    }
     case 'init':
       init();
       return;
     case 'hook':
       await runHook(rest[1]);
       return;
-    case undefined: {
-      // Bare invocation: make "npx/global install → run once in a folder"
-      // the whole setup story. URL-only invocations (e.g. `ari-hooks
-      // --web-url ...`) still run the full setup with the new URLs.
-      if (!loadConfig().token) {
-        await login();
+    case undefined:
+      // URL-only invocations (e.g. `ari-hooks --web-url ...`) are a
+      // complete action — setUrls already printed the resulting config.
+      if (!flags.webUrl && !flags.apiUrl && !flags.resetUrls) {
+        console.log(USAGE);
       }
-      init();
       return;
-    }
     default:
       console.error(`Unknown command: ${command}\n`);
       console.log(USAGE);

package/src/hooks.js

@@ -3,6 +3,7 @@ import {
   mkdirSync,
   readFileSync,
   writeFileSync,
+  writeSync,
   rmSync,
   appendFileSync,
 } from 'node:fs';
@@ -128,6 +129,89 @@ async function onStop(input) {
   rmSync(sessionPath(input.session_id), { force: true });
 }
 
+const MAX_TASKS = 3;
+const MAX_TASK_NAME_LENGTH = 200;
+
+const oneLine = (text) =>
+  text.replace(/\s+/g, ' ').trim().slice(0, MAX_TASK_NAME_LENGTH);
+
+/**
+ * SessionStart: ask Ari for the top tasks Claude can take care of right now
+ * and surface them at boot — a visible list for the user (systemMessage)
+ * plus the full prompts for Claude (additionalContext) so it can run
+ * whichever one the user picks.
+ */
+async function onSessionStart(input) {
+  // Compaction restarts the session mid-conversation; the tasks were
+  // already offered, so don't show (or inject) them again.
+  if (input.source === 'compact') return;
+
+  const config = loadConfig();
+  if (!config.token) return;
+
+  const response = await fetch(new URL('/agent-tasks', getApiUrl(config)), {
+    headers: { Authorization: `Bearer ${config.token}` },
+    signal: AbortSignal.timeout(SEND_TIMEOUT_MS),
+  });
+  if (!response.ok) {
+    throw new Error(`GET /agent-tasks failed: ${response.status}`);
+  }
+
+  const body = await response.json();
+  // The API wraps the list ({ tasks: [...] }); accept a bare array too.
+  const list = Array.isArray(body) ? body : Array.isArray(body?.tasks) ? body.tasks : [];
+  const tasks = list
+    .filter(
+      (t) =>
+        t &&
+        typeof t.taskName === 'string' &&
+        t.taskName.trim() &&
+        typeof t.prompt === 'string' &&
+        t.prompt.trim()
+    )
+    .slice(0, MAX_TASKS);
+  if (tasks.length === 0) return;
+
+  // Claude Code renders systemMessage with ANSI intact; the leading \n
+  // pushes our block below the fixed "SessionStart:<source> says:" prefix.
+  const BOLD = '\x1b[1m';
+  const CYAN = '\x1b[36m';
+  const GREY = '\x1b[37m';
+  const RESET = '\x1b[0m';
+  const visibleList = tasks
+    .map((t, i) => `  ${BOLD}${i + 1}.${RESET} ${oneLine(t.taskName)}`)
+    .join('\n');
+  const systemMessage =
+    `\n${BOLD}${CYAN}✻ Ari — things Claude can take care of for you right now${RESET}\n` +
+    `${visibleList}\n` +
+    `${GREY}Reply "run task 1" (or the task name) to start one.${RESET}`;
+
+  const additionalContext =
+    `The user has Ari connected via ari-hooks. At session start the user was ` +
+    `shown this list of suggested tasks:\n\n` +
+    tasks
+      .map(
+        (t, i) =>
+          `Task ${i + 1}: ${oneLine(t.taskName)}\nPrompt: ${clamp(t.prompt)}`
+      )
+      .join('\n\n') +
+    `\n\nIf the user asks to run one of these tasks (by number or name), ` +
+    `carry out that task's prompt as if the user had typed it. Do not start ` +
+    `any of these tasks unless the user asks.`;
+
+  // writeSync: process.exit(0) in runHook would race an async stdout write.
+  writeSync(
+    1,
+    JSON.stringify({
+      systemMessage,
+      hookSpecificOutput: {
+        hookEventName: 'SessionStart',
+        additionalContext,
+      },
+    }) + '\n'
+  );
+}
+
 /**
  * Entry point for `ari-hooks hook <event>`. Hooks must never break the
  * user's Claude Code session: all failures are swallowed (logged to
@@ -141,6 +225,8 @@ export async function runHook(event) {
       await onUserPromptSubmit(input);
     } else if (event === 'stop') {
       await onStop(input);
+    } else if (event === 'session-start') {
+      await onSessionStart(input);
     }
   } catch (err) {
     logError(err);

package/src/init.js

@@ -2,6 +2,7 @@ import { join } from 'node:path';
 import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 
 const HOOK_EVENTS = {
+  SessionStart: 'ari-hooks hook session-start',
   UserPromptSubmit: 'ari-hooks hook user-prompt-submit',
   Stop: 'ari-hooks hook stop',
 };
@@ -50,6 +51,7 @@ export function init(cwd = process.cwd()) {
   writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
   console.log(`✓ Ari hooks added to ${settingsPath}`);
   console.log(
-    'Claude Code sessions in this folder will now share each request and its outcome with Ari.'
+    'Claude Code sessions in this folder will now share each request and its outcome with Ari,'
   );
+  console.log('and show suggested Ari tasks when a session starts.');
 }