create-ai-memory 0.1.0

package/install.sh

@@ -0,0 +1,124 @@
+#!/usr/bin/env bash
+# ai-memory installer. Interactive when run in a terminal (banner + prompts),
+# and non-interactive when piped (npx, CI): it takes defaults or environment
+# overrides and never blocks. Idempotent; it never clobbers existing vault notes
+# and never double-appends to ~/.zshrc.
+set -euo pipefail
+
+HERE="$(cd "$(dirname "$0")" && pwd)"
+
+# Interactive only when both stdin and stdout are a terminal.
+INTERACTIVE=0
+[ -t 0 ] && [ -t 1 ] && INTERACTIVE=1
+
+# ask <var> <prompt> <default>: read a value interactively, else take the default
+# (or an existing environment value of the same name).
+ask() {
+  local __var="$1" __prompt="$2" __default="$3" __cur __reply
+  __cur="${!__var:-}"
+  [ -n "$__cur" ] && __default="$__cur"
+  if [ "$INTERACTIVE" -eq 1 ]; then
+    read -r -p "  $__prompt [$__default] " __reply || true
+    printf -v "$__var" '%s' "${__reply:-$__default}"
+  else
+    printf -v "$__var" '%s' "$__default"
+  fi
+}
+
+confirm() { # confirm <prompt>  -> 0 for yes; defaults to yes, and yes when piped
+  [ "$INTERACTIVE" -eq 0 ] && return 0
+  local __reply
+  read -r -p "  $1 [Y/n] " __reply || true
+  case "${__reply:-Y}" in [Nn]*) return 1 ;; *) return 0 ;; esac
+}
+
+# Color only when it lands in a real terminal that wants it.
+supports_color() {
+  [ "$INTERACTIVE" -eq 1 ] || return 1
+  [ -z "${NO_COLOR:-}" ] || return 1
+  [ "${TERM:-}" != "dumb" ] || return 1
+}
+
+# ANSI Shadow "AI MEMORY" with a teal->violet vertical gradient (24-bit color),
+# degrading to plain block art when color is unavailable.
+banner() {
+  local art=(
+' █████╗ ██╗    ███╗   ███╗███████╗███╗   ███╗ ██████╗ ██████╗ ██╗   ██╗'
+'██╔══██╗██║    ████╗ ████║██╔════╝████╗ ████║██╔═══██╗██╔══██╗╚██╗ ██╔╝'
+'███████║██║    ██╔████╔██║█████╗  ██╔████╔██║██║   ██║██████╔╝ ╚████╔╝ '
+'██╔══██║██║    ██║╚██╔╝██║██╔══╝  ██║╚██╔╝██║██║   ██║██╔══██╗  ╚██╔╝  '
+'██║  ██║██║    ██║ ╚═╝ ██║███████╗██║ ╚═╝ ██║╚██████╔╝██║  ██║   ██║   '
+'╚═╝  ╚═╝╚═╝    ╚═╝     ╚═╝╚══════╝╚═╝     ╚═╝ ╚═════╝ ╚═╝  ╚═╝   ╚═╝   '
+  )
+  local grad=( '45;212;191' '56;189;248' '59;130;246' '99;102;241' '139;92;246' '168;85;247' )
+  echo
+  if supports_color; then
+    local i
+    for i in "${!art[@]}"; do
+      printf '\033[1;38;2;%sm%s\033[0m\n' "${grad[$i]}" "${art[$i]}"
+    done
+    printf '\033[2m   persistent, agent-agnostic session memory · one vault, any CLI\033[0m\n\n'
+  else
+    printf '%s\n' "${art[@]}"
+    printf '   persistent, agent-agnostic session memory - one vault, any CLI\n\n'
+  fi
+}
+
+banner
+
+# --- gather settings ---------------------------------------------------------
+AI_MEM_ROOT="${AI_MEM_ROOT:-$HOME/.ai-memory/_Ai_Memory}"
+ask AI_MEM_ROOT   "Where should your memory vault live?" "$AI_MEM_ROOT"
+AI_MEM_AGENTS="${AI_MEM_AGENTS:-claude codex gemini cursor}"
+ask AI_MEM_AGENTS "Which agents should get <agent>-start launchers?" "$AI_MEM_AGENTS"
+
+# --- scaffold the vault ------------------------------------------------------
+echo
+echo "  scaffolding vault at: $AI_MEM_ROOT"
+mkdir -p "$AI_MEM_ROOT/_projects" "$AI_MEM_ROOT/_session_logs"
+
+copy_if_absent() { # never overwrite the user's real notes on a re-run
+  local src="$1" dst="$2"
+  if [ -e "$dst" ]; then echo "    keep   ${dst##*/}"; else cp "$src" "$dst"; echo "    create ${dst##*/}"; fi
+}
+copy_if_absent "$HERE/vault-template/_Global_Profile.md"                 "$AI_MEM_ROOT/_Global_Profile.md"
+copy_if_absent "$HERE/vault-template/_Standards.md"                      "$AI_MEM_ROOT/_Standards.md"
+copy_if_absent "$HERE/vault-template/_projects/_project_template.md"     "$AI_MEM_ROOT/_projects/_project_template.md"
+copy_if_absent "$HERE/vault-template/_session_logs/_session_template.md" "$AI_MEM_ROOT/_session_logs/_session_template.md"
+
+# --- assemble the ~/.zshrc lines ---------------------------------------------
+LINES="export AI_MEM_ROOT=\"$AI_MEM_ROOT\""
+if [ "$AI_MEM_AGENTS" != "claude codex gemini cursor" ]; then
+  LINES="$LINES
+export AI_MEM_AGENTS=\"$AI_MEM_AGENTS\""
+fi
+LINES="$LINES
+source \"$HERE/shell/ai-mem.zsh\""
+
+RC="$HOME/.zshrc"
+SOURCE_LINE="source \"$HERE/shell/ai-mem.zsh\""
+
+echo
+if [ -f "$RC" ] && grep -qF "$SOURCE_LINE" "$RC"; then
+  echo "  ~/.zshrc already sources ai-memory; leaving it untouched."
+elif confirm "Append the setup lines to ~/.zshrc now?"; then
+  { printf '\n# ai-memory (https://github.com/rambaarde/create-ai-memory)\n'; printf '%s\n' "$LINES"; } >> "$RC"
+  echo "  added to $RC"
+  echo
+  echo "  Reload your shell:  exec zsh"
+else
+  cat <<EOF
+
+  Add these lines to your ~/.zshrc yourself:
+
+$(printf '%s\n' "$LINES" | sed 's/^/    /')
+EOF
+fi
+
+cat <<EOF
+
+  Done. From inside any git repo, run:  claude-start
+  (or codex-start / gemini-start / cursor-start)
+
+  Optional integrations: see $HERE/hooks/  and the README.
+EOF

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "create-ai-memory",
+  "version": "0.1.0",
+  "description": "Persistent, agent-agnostic session memory for AI coding CLIs (Claude Code, Codex, Gemini, Cursor, opencode). One Markdown vault, any agent.",
+  "bin": {
+    "create-ai-memory": "bin/create-ai-memory.js"
+  },
+  "type": "commonjs",
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "bin/",
+    "shell/",
+    "hooks/",
+    "vault-template/",
+    "install.sh",
+    "create-ai-memory.plugin.zsh",
+    "LICENSE"
+  ],
+  "keywords": [
+    "ai",
+    "memory",
+    "claude",
+    "codex",
+    "gemini",
+    "cursor",
+    "opencode",
+    "cli",
+    "agent",
+    "obsidian",
+    "zsh"
+  ],
+  "homepage": "https://github.com/rambaarde/create-ai-memory#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rambaarde/create-ai-memory.git"
+  },
+  "bugs": {
+    "url": "https://github.com/rambaarde/create-ai-memory/issues"
+  },
+  "license": "MIT",
+  "author": "Ram Christopher Baarde"
+}

package/shell/adapters.zsh

@@ -0,0 +1,75 @@
+# Agent launch adapters for ai-mem.
+#
+# One function per agent: _ai_adapter_<name>. It receives:
+#   $1  memory_prompt  — assembled vault context + session-mode block
+#   $2  mode_block      — just the session-mode instructions (may be empty)
+#   $3… extra CLI args  — anything passed to <name>-start (e.g. files to open)
+#
+# Add a new agent (opencode, aider, …) by defining _ai_adapter_<name> here and
+# listing <name> in AI_MEM_AGENTS (see ai-mem.zsh). No core edits needed.
+
+# Codex: --add-dir grants read access to the vault; prompt is positional.
+_ai_adapter_codex() {
+    local memory_prompt="$1"
+    codex --add-dir "$AI_MEM_ROOT" "$memory_prompt"
+}
+
+# Claude Code: --add-dir is variadic, so the prompt must come FIRST or it gets
+# swallowed as a bogus directory and Claude starts with no initial prompt.
+_ai_adapter_claude() {
+    local memory_prompt="$1" mode_block="$2"
+    if [[ -n "$mode_block" ]]; then
+        claude "$memory_prompt" --add-dir "$AI_MEM_ROOT" --append-system-prompt "$mode_block"
+    else
+        claude "$memory_prompt" --add-dir "$AI_MEM_ROOT"
+    fi
+}
+
+# Gemini CLI: --include-directories for vault access, -i for the initial prompt.
+_ai_adapter_gemini() {
+    local memory_prompt="$1"
+    gemini --include-directories "$AI_MEM_ROOT" -i "$memory_prompt"
+}
+
+# Cursor has no CLI prompt path, so persist the session's skill choices as a
+# managed always-apply rule that this adapter rewrites each launch (and clears
+# when nothing is selected).
+_ai_adapter_cursor() {
+    local memory_prompt="$1" mode_block="$2"
+    shift 2
+    local cursor_rule="$HOME/.cursor/rules/_ai-session.mdc"
+    if [[ -n "$mode_block" ]]; then
+        mkdir -p "$HOME/.cursor/rules"
+        {
+            print -r -- "---"
+            print -r -- "description: Active AI session skills (managed by cursor-start; rewritten each launch, cleared when none chosen)."
+            print -r -- "globs:"
+            print -r -- "alwaysApply: true"
+            print -r -- "---"
+            print -r --
+            print -r -- "$mode_block"
+        } > "$cursor_rule"
+    else
+        rm -f "$cursor_rule"
+    fi
+    if command -v cursor >/dev/null 2>&1; then
+        cursor "$@"
+    else
+        open -a Cursor
+    fi
+}
+
+# opencode (sst/opencode): the TUI seeds its first message from --prompt. It has
+# no --add-dir, so vault access rides on the inlined profile/standards in the
+# prompt plus the absolute note paths the agent can read on demand.
+_ai_adapter_opencode() {
+    local memory_prompt="$1"
+    opencode --prompt "$memory_prompt"
+}
+
+# --- Example: add another agent by defining its adapter and listing it in
+# AI_MEM_AGENTS. aider takes the initial instruction via --message:
+# _ai_adapter_aider() {
+#     local memory_prompt="$1"
+#     aider --message "$memory_prompt"
+# }