@jetrabbits/agentic 0.0.5 → 0.1.0

package/AGENTS.md

@@ -76,6 +76,13 @@ Cross-cutting practices that apply to every project regardless of area.
 - Resolve the library or framework identity first, then request focused docs for the exact task and version when version matters.
 - If Context7 is unavailable, state that explicitly and fall back to local docs or official project documentation.
 
+### MemPalace + Context Strategy
+
+- If MemPalace MCP is enabled and available, load project business/domain context from MemPalace first.
+- If Context7 MCP is enabled and available, use it specifically for framework/library/API documentation.
+- If both are available, combine them: MemPalace for project/business knowledge, Context7 for framework-level references.
+- If MCP providers are unavailable, continue with standard local-repo discovery and context-building as fallback.
+
 ### Code Style
 
 - Write self-documenting code with meaningful names — comments explain why, not what.

package/README.md

@@ -164,6 +164,9 @@ Each agent has a `vibe` (one-line personality), `Identity`, `Communication Style
 
 Running `agentic` in a target project installs shared guidance into the project's `.agent/` directory and copies any
 selected platform extensions into tool-specific directories such as `.claude/`, `.opencode/`, and `.codex/`.
+Generated operating guidance is written to `AGENTS.md` at the project root for most agents. OpenCode receives the same
+generated guidance at `.opencode/AGENTS.md`; multi-target installs that include OpenCode and another agent write both
+files.
 
 ```text
 project/.agent/

package/agentic

@@ -731,11 +731,6 @@ elif suffix == ".json":
     data = json.loads(text)
     if not isinstance(data, dict):
         raise SystemExit(f"Cannot add agentic metadata to non-object JSON: {dest}")
-    data["_agentic"] = {
-        "generated_by": "agentic",
-        "source": source_ref,
-        "repository": repo,
-    }
     output = json.dumps(data, indent=2, ensure_ascii=False) + "\n"
 elif suffix in {".ts", ".tsx", ".js", ".jsx", ".css"}:
     output = commented(text, "//")
@@ -1071,11 +1066,6 @@ def add_marker(file_path: Path, target: Path, source_ref: str) -> str:
         data = json.loads(text)
         if not isinstance(data, dict):
             raise SystemExit(f"Cannot add agentic metadata to non-object JSON: {target}")
-        data["_agentic"] = {
-            "generated_by": "agentic",
-            "source": source_ref,
-            "repository": repo,
-        }
         return json.dumps(data, indent=2, ensure_ascii=False) + "\n"
     if suffix in {".ts", ".tsx", ".js", ".jsx", ".css"}:
         return commented(text, "//", source_ref)
@@ -1182,11 +1172,6 @@ namespace = {
 }
 exec(body, namespace)
 data = namespace["data"]
-data["_agentic"] = {
-    "generated_by": "agentic",
-    "source": source_ref,
-    "repository": repo,
-}
 path.write_text(json.dumps(data, indent=2, ensure_ascii=False) + "\n", encoding="utf-8")
 PY
   register_managed_file "$dest" "$source_ref" "internal"
@@ -1314,6 +1299,37 @@ mcp_servers["context7"] = context7
   write_json_config_file "$dest" "generated:context7-cursor-config" "$body"
 }
 
+
+write_context7_kilocode_config() {
+  local dest="$PROJECT_DIR/.kilocode/mcp.json"
+  local body
+  body='
+mcp_servers = data.setdefault("mcpServers", {})
+context7 = {
+    "url": "https://mcp.context7.com/mcp",
+}
+if context7_api_key:
+    context7["headers"] = {"CONTEXT7_API_KEY": context7_api_key}
+mcp_servers["context7"] = context7
+'
+  write_json_config_file "$dest" "generated:context7-kilocode-config" "$body"
+}
+
+write_context7_antigravity_config() {
+  local dest="$HOME/.gemini/antigravity/mcp_config.json"
+  local body
+  body='
+mcp_servers = data.setdefault("mcpServers", {})
+context7 = {
+    "url": "https://mcp.context7.com/mcp",
+}
+if context7_api_key:
+    context7["headers"] = {"CONTEXT7_API_KEY": context7_api_key}
+mcp_servers["context7"] = context7
+'
+  write_json_config_file "$dest" "generated:context7-antigravity-config" "$body"
+}
+
 write_context7_gemini_config() {
   local dest="$PROJECT_DIR/.gemini/settings.json"
   local body
@@ -1329,12 +1345,176 @@ mcp_servers["context7"] = context7
   write_json_config_file "$dest" "generated:context7-gemini-config" "$body"
 }
 
+write_mempalace_opencode_config() {
+  local dest="$1"
+  local body
+  body='
+mcp = data.setdefault("mcp", {})
+mcp["mempalace"] = {"type": "local", "command": ["mempalace-mcp", "--palace", ".mempalace"]}
+'
+  write_json_config_file "$dest" "generated:mempalace-opencode-config" "$body"
+}
+
+write_mempalace_codex_config() {
+  local dest="$PROJECT_DIR/.codex/config.toml"
+  local body
+  body="$(python3 - "$dest" <<'PYCODE'
+import pathlib, sys
+path = pathlib.Path(sys.argv[1])
+text = path.read_text(encoding='utf-8') if path.exists() else ''
+block = "[mcp_servers.mempalace]\ncommand = \"mempalace-mcp\"\nargs = [\"--palace\", \".mempalace\"]\n"
+if block not in text:
+    if text and not text.endswith("\n"):
+        text += "\n"
+    text += block
+print(text, end="")
+PYCODE
+)"
+  write_generated_text_file "$dest" "generated:mempalace-codex-config" "$body"
+}
+
+write_mempalace_generic_json_config() {
+  local dest="$1"
+  local marker="$2"
+  local body
+  body='
+servers = data.setdefault("mcpServers", {})
+servers["mempalace"] = {"command": "mempalace-mcp", "args": ["--palace", ".mempalace"]}
+'
+  write_json_config_file "$dest" "$marker" "$body"
+}
+
+print_mempalace_project_setup_instructions() {
+  log "MemPalace setup instructions for target project: $PROJECT_DIR"
+  cat <<EOF
+1) Ensure Python is installed and available in PATH.
+2) Install MemPalace:
+   pip install mempalace
+3) Initialize project-local MemPalace cache:
+   mkdir -p "$PROJECT_DIR/.mempalace"
+   mempalace init "$PROJECT_DIR/.mempalace" --yes --auto-mine
+4) Index existing project memory:
+   # optional if --auto-mine was skipped
+   mempalace mine "$PROJECT_DIR/.mempalace"
+5) Verify in your IDE/agent that MemPalace MCP tools are connected.
+Note: Ollama at localhost:11434 is optional; MemPalace can run heuristics-only without it.
+EOF
+}
+
+setup_mempalace_for_agentic_opencode() {
+  local step_prefix="MemPalace setup"
+
+  log "$step_prefix [1/4] Checking Python availability"
+  if ! command -v python3 >/dev/null 2>&1 && ! command -v python >/dev/null 2>&1; then
+    warn "Python is not installed. Install Python 3 first, then run: pip install mempalace"
+    warn "Install help: https://www.python.org/downloads/"
+    return 1
+  fi
+  log "$step_prefix [1/4] Python check passed"
+
+  log "$step_prefix [2/4] Checking pip availability"
+  if ! command -v pip >/dev/null 2>&1 && ! command -v pip3 >/dev/null 2>&1; then
+    warn "pip is not available. Install pip for Python 3, then run: pip install mempalace"
+    return 1
+  fi
+  log "$step_prefix [2/4] pip check passed"
+
+  log "$step_prefix [3/4] Installing mempalace package"
+  if pip install mempalace >/dev/null 2>&1; then
+    log "MemPalace package installed via 'pip install mempalace'"
+  else
+    warn "Unable to auto-install mempalace via pip; continuing with manual setup instructions"
+    print_mempalace_project_setup_instructions
+    return 1
+  fi
+
+  log "$step_prefix [4/4] Initializing project memory at $PROJECT_DIR/.mempalace"
+  if command -v mempalace >/dev/null 2>&1; then
+    mkdir -p "$PROJECT_DIR/.mempalace" || warn "Failed: mkdir -p \"$PROJECT_DIR/.mempalace\""
+    if mempalace init "$PROJECT_DIR/.mempalace" --yes --auto-mine >/dev/null 2>&1; then
+      log "MemPalace init completed"
+    else
+      warn "Failed: mempalace init \"$PROJECT_DIR/.mempalace\" --yes --auto-mine"
+    fi
+    if mempalace mine "$PROJECT_DIR/.mempalace" >/dev/null 2>&1; then
+      log "MemPalace mine completed"
+    else
+      warn "Failed: mempalace mine \"$PROJECT_DIR/.mempalace\""
+    fi
+    log "$step_prefix [4/4] Initialization step finished"
+  else
+    warn "mempalace command is unavailable after install; please run setup manually"
+    print_mempalace_project_setup_instructions
+    return 1
+  fi
+}
+
+configure_mempalace_if_needed() {
+  if ! selected_agent_os_contains "opencode" \
+    && ! selected_agent_os_contains "codex" \
+    && ! selected_agent_os_contains "claude" \
+    && ! selected_agent_os_contains "cursor" \
+    && ! selected_agent_os_contains "gemini" \
+    && ! selected_agent_os_contains "antigravity"; then
+    return
+  fi
+
+  local enable_mempalace="N"
+  if [[ -n "${AGENTIC_ENABLE_MEMPALACE:-}" ]]; then
+    enable_mempalace="$(trim "${AGENTIC_ENABLE_MEMPALACE}")"
+  elif is_interactive_terminal && [[ -z "${AGENTIC_TEST_SOURCE_AGENTIC:-}" ]]; then
+    read -r -p "Enable MemPalace MCP memory integration? [y/N]: " enable_mempalace
+    enable_mempalace="$(trim "${enable_mempalace:-y}")"
+    if [[ -z "$enable_mempalace" ]]; then enable_mempalace="y"; fi
+  fi
+  if [[ "$enable_mempalace" =~ ^[Nn]$ ]]; then
+    log "Skipped MemPalace MCP configuration"
+    return
+  fi
+
+  if selected_agent_os_contains "opencode"; then
+    setup_mempalace_for_agentic_opencode || true
+  else
+    print_mempalace_project_setup_instructions
+  fi
+
+  if command -v mempalace-mcp >/dev/null 2>&1; then
+    if mempalace-mcp --help >/dev/null 2>&1; then
+      log "MemPalace MCP runtime check succeeded via 'mempalace-mcp'"
+    else
+      warn "MemPalace MCP runtime check failed; continuing without runtime validation"
+    fi
+  else
+    warn "mempalace-mcp is unavailable; install/repair MemPalace and re-run setup"
+  fi
+
+  if selected_agent_os_contains "opencode"; then
+    write_mempalace_opencode_config "$PROJECT_DIR/opencode.json"
+    write_mempalace_opencode_config "$PROJECT_DIR/.opencode/opencode.json"
+  fi
+  if selected_agent_os_contains "codex"; then write_mempalace_codex_config; fi
+  if selected_agent_os_contains "claude"; then
+    write_mempalace_generic_json_config "$PROJECT_DIR/.mcp.json" "generated:mempalace-claude-config"
+  fi
+  if selected_agent_os_contains "cursor"; then
+    write_mempalace_generic_json_config "$PROJECT_DIR/.cursor/mcp.json" "generated:mempalace-cursor-config"
+  fi
+  if selected_agent_os_contains "gemini"; then
+    write_mempalace_generic_json_config "$PROJECT_DIR/.gemini/settings.json" "generated:mempalace-gemini-config"
+  fi
+  if selected_agent_os_contains "antigravity"; then
+    write_mempalace_generic_json_config "$HOME/.gemini/antigravity/mcp_config.json" "generated:mempalace-antigravity-config"
+  fi
+}
+
 configure_context7_if_needed() {
   if ! selected_agent_os_contains "opencode" \
     && ! selected_agent_os_contains "codex" \
     && ! selected_agent_os_contains "claude" \
     && ! selected_agent_os_contains "cursor" \
-    && ! selected_agent_os_contains "gemini"; then
+    && ! selected_agent_os_contains "gemini" \
+    && ! selected_agent_os_contains "kilocode" \
+    && ! selected_agent_os_contains "antigravity"; then
     return
   fi
 
@@ -1376,6 +1556,14 @@ configure_context7_if_needed() {
   if selected_agent_os_contains "gemini"; then
     write_context7_gemini_config
   fi
+
+  if selected_agent_os_contains "kilocode"; then
+    write_context7_kilocode_config
+  fi
+
+  if selected_agent_os_contains "antigravity"; then
+    write_context7_antigravity_config
+  fi
 }
 
 write_default_opencode_plugin_config() {
@@ -1610,11 +1798,31 @@ append_root_agents_template() {
 
 generate_agents_md() {
   local project_dir="$1"
-  local out="$project_dir/AGENTS.md"
+  local outputs=()
+  local needs_root=false
+  local agent_os
+
+  if selected_agent_os_contains "opencode"; then
+    unique_append "$project_dir/.opencode/AGENTS.md" outputs
+  fi
+
+  for agent_os in "${SELECTED_AGENT_OS[@]}"; do
+    if [[ "$agent_os" != "opencode" ]]; then
+      needs_root=true
+      break
+    fi
+  done
+
+  if [[ "$needs_root" == true ]] || ! selected_agent_os_contains "opencode"; then
+    unique_append "$project_dir/AGENTS.md" outputs
+  fi
 
   if [[ "$DRY_RUN" == true ]]; then
-    log "DRY-RUN generate $out"
-    unique_append "$out" COPIED_PATHS
+    local dry_run_out
+    for dry_run_out in "${outputs[@]}"; do
+      log "DRY-RUN generate $dry_run_out"
+      unique_append "$dry_run_out" COPIED_PATHS
+    done
     return
   fi
 
@@ -1629,7 +1837,10 @@ generate_agents_md() {
     append_specialization_template "$tmp" "$spec_key"
   done
 
-  write_file_with_agentic_marker "$tmp" "$out" "generated:AGENTS.md"
+  local out
+  for out in "${outputs[@]}"; do
+    write_file_with_agentic_marker "$tmp" "$out" "generated:AGENTS.md"
+  done
   rm -f "$tmp"
 }
 
@@ -1734,6 +1945,70 @@ print_report() {
   fi
 }
 
+detect_runtime_platform_label() {
+  local platform
+  platform="$(detect_platform)"
+  if [[ "$platform" == "linux" ]] && grep -qiE "(microsoft|wsl)" /proc/version 2>/dev/null; then
+    echo "wsl"
+    return
+  fi
+  echo "$platform"
+}
+
+get_agent_binary_name() {
+  local agent_os="$1"
+  case "$agent_os" in
+    codex) echo "codex" ;;
+    claude) echo "claude" ;;
+    opencode) echo "opencode" ;;
+    cursor) echo "cursor-agent" ;;
+    gemini) echo "gemini" ;;
+    antigravity) echo "antigravity" ;;
+    *) echo "" ;;
+  esac
+}
+
+print_missing_agent_binary_guides() {
+  local platform_label
+  platform_label="$(detect_runtime_platform_label)"
+  local missing_lines=()
+  local agent_os
+
+  for agent_os in "${SELECTED_AGENT_OS[@]}"; do
+    local binary_name
+    binary_name="$(get_agent_binary_name "$agent_os")"
+    if [[ -z "$binary_name" ]]; then
+      continue
+    fi
+    if command -v "$binary_name" >/dev/null 2>&1; then
+      continue
+    fi
+
+    local install_link=""
+    case "$agent_os" in
+      codex) install_link="https://github.com/openai/codex" ;;
+      claude) install_link="https://docs.anthropic.com/en/docs/claude-code/quickstart" ;;
+      opencode) install_link="https://opencode.ai/docs" ;;
+      cursor) install_link="https://docs.cursor.com/get-started/installation" ;;
+      gemini) install_link="https://github.com/google-gemini/gemini-cli" ;;
+      antigravity) install_link="https://github.com/getantigravity/antigravity" ;;
+    esac
+
+    missing_lines+=("- $agent_os: binary '$binary_name' is not installed on $platform_label.")
+    if [[ -n "$install_link" ]]; then
+      missing_lines+=("  Install guide: $install_link")
+    fi
+  done
+
+  if [[ "${#missing_lines[@]}" -eq 0 ]]; then
+    return
+  fi
+
+  echo
+  echo "${COLOR_HEADER}=== Agent binary setup recommendations ===${COLOR_RESET}"
+  printf '%s\n' "${missing_lines[@]}"
+}
+
 run_install() {
   ensure_repo_layout
   ensure_python_available
@@ -1746,8 +2021,10 @@ run_install() {
   copy_specialization_assets "$PROJECT_DIR"
   generate_agents_md "$PROJECT_DIR"
   configure_context7_if_needed
+  configure_mempalace_if_needed
   write_agentic_manifest "$PROJECT_DIR"
   print_report
+  print_missing_agent_binary_guides
 }
 
 ascii_banner() {
@@ -2274,8 +2551,13 @@ update_installed_binary_from_repo() {
     return
   fi
 
-  cp "$source_path" "$target"
-  chmod +x "$target"
+  local target_dir target_tmp
+  target_dir="$(dirname "$target")"
+  target_tmp="$(mktemp "$target_dir/.agentic-update.XXXXXX")"
+
+  cp "$source_path" "$target_tmp"
+  chmod +x "$target_tmp"
+  mv -f "$target_tmp" "$target"
   log "Updated installed binary: $target"
 }
 
@@ -2396,6 +2678,9 @@ case "$COMMAND" in
           shift 2
           ;;
         --agent-os)
+          if [[ "${#SELECTED_AGENT_OS[@]}" -eq 1 && "${SELECTED_AGENT_OS[0]}" == "$DEFAULT_AGENT_OS" ]]; then
+            SELECTED_AGENT_OS=()
+          fi
           split_csv "$2" SELECTED_AGENT_OS
           shift 2
           ;;

package/docs/agentic-lifecycle.md

@@ -101,3 +101,14 @@ When `.agentic.json` exists in the target project, `agentic install` treats the
 - skipped paths are recorded in `.agentic.json`.
 
 Every copied or generated file carries an internal marker. Markdown uses YAML front matter, comment-capable formats use comments, and JSON uses an `_agentic` object.
+
+## MemPalace install and validation logs
+
+When MemPalace MCP is enabled during interactive install, `agentic` now reports setup progress in explicit steps so users can see what succeeded or failed:
+
+1. Python availability check
+2. pip availability check
+3. `pip install mempalace`
+4. Project initialization (`mempalace init` and `mempalace mine`)
+
+After setup, runtime validation uses `mempalace-mcp --help` (the MCP entrypoint) instead of validating only the Python module import path. This avoids false warnings where the package is installed successfully but a pre-install runtime probe ran too early.

package/docs/agentic-token-minimization/README.md

@@ -51,6 +51,8 @@ OPENCODE_TELEGRAM_CHAT_ID
 - `.mcp.json` for Claude Code project-scoped MCP servers
 - `.cursor/mcp.json`
 - `.gemini/settings.json`
+- `.kilocode/mcp.json` for `kilocode`
+- `~/.gemini/antigravity/mcp_config.json` for `antigravity` (global user config)
 
 Interactive installs ask whether to enable Context7. If enabled, the Context7 API key is optional. Empty keys keep the install usable with default Context7 limits or rule-only fallback behavior. Non-interactive installs enable Context7 only when `CONTEXT7_API_KEY` is already set. Generated guidance requires agents to use Context7 for framework, SDK, library, and API documentation before relying on model memory when the project config is present.
 

package/docs/agentic-usage.md

@@ -73,7 +73,7 @@ agentic install \
   --specializations software.general,software.backend
 ```
 
-After install, `agentic` writes `.agentic.json` in the target project. It records copied/generated files and their hashes. A later install rerun updates only manifest-managed files and skips files changed by the user.
+After install, `agentic` writes `.agentic.json` in the target project. It records copied/generated files and their hashes. A later install rerun updates only manifest-managed files and skips files changed by the user. Generated guidance is written to root `AGENTS.md` for most agents and to `.opencode/AGENTS.md` when OpenCode is selected; multi-target installs that include OpenCode and another agent write both files.
 
 List available options:
 
@@ -136,10 +136,22 @@ Non-interactive installs create a disabled config when no config exists. Telegra
 
 ## Context7
 
-For `opencode` and `codex`, interactive installs ask whether to add project-level Context7 MCP configuration. If enabled, the Context7 API key prompt is optional; leave it empty to configure Context7 without a key.
+For `opencode`, `codex`, `claude`, `cursor`, `gemini`, `kilocode`, and `antigravity`, interactive installs ask whether to add Context7 MCP configuration. If enabled, the Context7 API key prompt is optional; leave it empty to configure Context7 without a key. Most targets use project-level files, while `antigravity` is written to the global user path `~/.gemini/antigravity/mcp_config.json`.
 
 Non-interactive installs skip Context7 unless `CONTEXT7_API_KEY` is set in the environment. Agents are instructed to use Context7 for framework, library, SDK, API, and setup documentation when the project config is present.
 
+## MemPalace
+
+For `opencode`, `codex`, `claude`, `cursor`, `gemini`, and `antigravity`, MemPalace MCP is configured as a local Python module instead of a hosted MCP URL. Install it first:
+
+```bash
+pip install mempalace
+```
+
+Generated configs run `mempalace-mcp --palace .mempalace` (or equivalent `command`/`args` format per IDE) so each project uses its local `.mempalace` directory.
+
+During install, if MemPalace is enabled, `agentic` also runs a runtime check using `python3 -m mempalace --help`. For OpenCode installs, `agentic` creates `<project>/.mempalace` and runs `mempalace init "<project>/.mempalace" --yes --auto-mine`. If checks fail (for example, package not installed yet), install continues and agents fall back to standard context discovery.
+
 ## Deprecated wrapper
 
 `agentos-install.sh` remains for backward compatibility and forwards to `agentic`. Prefer `agentic` in new usage and documentation.

package/docs/opencode_setup.md

@@ -43,3 +43,6 @@ OPENCODE_TELEGRAM_CHAT_ID
 ```
 
 Non-interactive `agentic install` defaults optional plugins to disabled when no config exists.
+
+For OpenCode targets, `agentic` writes generated operating guidance to `.opencode/AGENTS.md`. If OpenCode is installed
+alongside another agent target, root `AGENTS.md` is generated as well for the non-OpenCode target.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jetrabbits/agentic",
-  "version": "0.0.5",
+  "version": "0.1.0",
   "description": "Agent Intelligence Configuration CLI",
   "bin": {
     "agentic": "bin/agentic.js"