agentdir-cli 0.7.7__tar.gz → 0.7.8__tar.gz

{agentdir_cli-0.7.7/src/agentdir_cli.egg-info → agentdir_cli-0.7.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentdir-cli
-Version: 0.7.7
+Version: 0.7.8
 Summary: Local-first Maildir-inspired work mailstore for software agents
 Author: AgentDir Contributors
 License-Expression: MIT
@@ -128,7 +128,8 @@ curl -fsSL https://raw.githubusercontent.com/jstxn/agentdir/main/scripts/install
 
 The installer uses `pipx` when available. Otherwise it creates a self-contained
 virtual environment under `~/.local/share/agentdir` and links the CLI into
-`~/.local/bin`.
+`~/.local/bin`. It does not edit Git configuration or ignore files; after
+installation it prints the explicit adoption choices.
 
 Verify:
 
@@ -155,7 +156,7 @@ available automatically during coding tasks:
 Package page: [@jstxn/agentdir-pi](https://pi.dev/packages/@jstxn/agentdir-pi)
 
 ```bash
-pi install npm:@jstxn/agentdir-pi@0.7.7
+pi install npm:@jstxn/agentdir-pi@0.7.8
 # or install directly from a local checkout / release tag:
 pi install /absolute/path/to/agentdir
 pi install git:github.com/jstxn/agentdir@<tag-or-commit>
@@ -174,6 +175,13 @@ Run once from a git repository:
 agentdir adopt
 ```
 
+Coding agents use the non-interactive form below so `.agentdir/` is ignored at
+the user level without creating a repository `.gitignore` change:
+
+```bash
+agentdir adopt --gitignore user
+```
+
 This is intentionally boring setup. It prepares the repository once, then agents
 operate AgentDir during normal coding work:
 
@@ -219,6 +227,10 @@ agentdir adopt --gitignore user     # write the user-level Git excludes file
 agentdir adopt --gitignore none     # leave ignore files unchanged
 ```
 
+Generated AgentDir guidance selects `--gitignore user` by default. The plain
+interactive command still prompts, and all three explicit choices remain
+available.
+
 Undo managed setup while keeping the `.agentdir` evidence store:
 
 ```bash

{agentdir_cli-0.7.7 → agentdir_cli-0.7.8}/README.md

@@ -95,7 +95,8 @@ curl -fsSL https://raw.githubusercontent.com/jstxn/agentdir/main/scripts/install
 
 The installer uses `pipx` when available. Otherwise it creates a self-contained
 virtual environment under `~/.local/share/agentdir` and links the CLI into
-`~/.local/bin`.
+`~/.local/bin`. It does not edit Git configuration or ignore files; after
+installation it prints the explicit adoption choices.
 
 Verify:
 
@@ -122,7 +123,7 @@ available automatically during coding tasks:
 Package page: [@jstxn/agentdir-pi](https://pi.dev/packages/@jstxn/agentdir-pi)
 
 ```bash
-pi install npm:@jstxn/agentdir-pi@0.7.7
+pi install npm:@jstxn/agentdir-pi@0.7.8
 # or install directly from a local checkout / release tag:
 pi install /absolute/path/to/agentdir
 pi install git:github.com/jstxn/agentdir@<tag-or-commit>
@@ -141,6 +142,13 @@ Run once from a git repository:
 agentdir adopt
 ```
 
+Coding agents use the non-interactive form below so `.agentdir/` is ignored at
+the user level without creating a repository `.gitignore` change:
+
+```bash
+agentdir adopt --gitignore user
+```
+
 This is intentionally boring setup. It prepares the repository once, then agents
 operate AgentDir during normal coding work:
 
@@ -186,6 +194,10 @@ agentdir adopt --gitignore user     # write the user-level Git excludes file
 agentdir adopt --gitignore none     # leave ignore files unchanged
 ```
 
+Generated AgentDir guidance selects `--gitignore user` by default. The plain
+interactive command still prompts, and all three explicit choices remain
+available.
+
 Undo managed setup while keeping the `.agentdir` evidence store:
 
 ```bash

{agentdir_cli-0.7.7 → agentdir_cli-0.7.8}/docs/AGENTIC_CODING.md

@@ -27,6 +27,15 @@ From a git repository:
 agentdir adopt
 ```
 
+For agent-driven, non-interactive setup, make the ignore destination explicit:
+
+```bash
+agentdir adopt --gitignore user
+```
+
+This keeps `.agentdir/` out of Git across repositories without changing a
+project's tracked `.gitignore`.
+
 This initializes `.agentdir`, installs managed Git hook shims, installs the
 Codex skill in the user skill directory, writes broad project guidance for
 common agent tools, asks interactive users where to ignore `.agentdir/`, runs
@@ -54,7 +63,7 @@ The user should not have to operate AgentDir during a normal coding session. Onc
 Agent responsibilities:
 
 - run `agentdir work start "<task>" --emit-context` when coding work begins
-- run `agentdir adopt` once if the repository has not been prepared yet
+- run `agentdir adopt --gitignore user` once if the repository has not been prepared yet
 - use `agentdir status` when a single health view is needed
 - emit context packs when retrieved context materially informs the work
 - record which context sources were consumed and cited when reporting lineage

{agentdir_cli-0.7.7 → agentdir_cli-0.7.8}/docs/INSTALL.md

@@ -28,6 +28,17 @@ The installer downloads release assets anonymously with `curl`. If `curl` is
 unavailable or the download fails, it falls back to authenticated GitHub CLI
 (`gh auth login`).
 
+The installer does not modify Git configuration or ignore files. It prints a
+post-install command that agents can use from a repository:
+
+```bash
+agentdir adopt --gitignore user
+```
+
+This appends `.agentdir/` to the configured user-level Git excludes file. Use
+`--gitignore project` for a repository `.gitignore` entry or `--gitignore none`
+to leave ignore files unchanged.
+
 The installer downloads the release wheel and installs it with `pipx` when available. If `pipx` is not installed, it falls back to a self-contained virtual environment at:
 
 ```text
@@ -65,7 +76,7 @@ Useful variants:
 ```bash
 agentdir update --install-skill none
 agentdir update --no-adopt
-agentdir update --version v0.7.7
+agentdir update --version v0.7.8
 agentdir update --dry-run
 ```
 
@@ -82,7 +93,7 @@ repo="$(mktemp -d)/agentdir-install-smoke"
 mkdir -p "$repo"
 git -C "$repo" init
 cd "$repo"
-agentdir adopt --install-skill store
+agentdir adopt --install-skill store --gitignore user
 agentdir work start "install smoke" --emit-context
 agentdir run -- python3 -c "print('agentdir install smoke')"
 agentdir evidence --brief
@@ -99,13 +110,13 @@ agentdir work finish --json
 If you already have the wheel asset:
 
 ```bash
-AGENTDIR_WHEEL=/path/to/agentdir_cli-0.7.7-py3-none-any.whl bash scripts/install.sh
+AGENTDIR_WHEEL=/path/to/agentdir_cli-0.7.8-py3-none-any.whl bash scripts/install.sh
 ```
 
 To force the virtual environment installer even when `pipx` is present:
 
 ```bash
-AGENTDIR_FORCE_VENV=1 AGENTDIR_WHEEL=/path/to/agentdir_cli-0.7.7-py3-none-any.whl bash scripts/install.sh
+AGENTDIR_FORCE_VENV=1 AGENTDIR_WHEEL=/path/to/agentdir_cli-0.7.8-py3-none-any.whl bash scripts/install.sh
 ```
 
 ## Roll Back To The Previous Release
@@ -122,13 +133,13 @@ curl -fsSL https://raw.githubusercontent.com/jstxn/agentdir/main/scripts/rollbac
 To choose a specific release:
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/jstxn/agentdir/main/scripts/rollback.sh | bash -s -- v0.7.6
+curl -fsSL https://raw.githubusercontent.com/jstxn/agentdir/main/scripts/rollback.sh | bash -s -- v0.7.7
 ```
 
 The equivalent manual rollback is:
 
 ```bash
-curl -fsSL https://raw.githubusercontent.com/jstxn/agentdir/main/scripts/install.sh | AGENTDIR_VERSION=v0.7.6 bash
+curl -fsSL https://raw.githubusercontent.com/jstxn/agentdir/main/scripts/install.sh | AGENTDIR_VERSION=v0.7.7 bash
 ```
 
 ## Optional Extras

{agentdir_cli-0.7.7 → agentdir_cli-0.7.8}/docs/PI_PACKAGE.md

@@ -9,7 +9,9 @@ skills/agentdir/SKILL.md
 
 The skill teaches Pi to start AgentDir sessions, wrap evidence-bearing shell
 commands, use local memory/context packs, and produce evidence-aware handoffs.
-It does not install the `agentdir` CLI; install AgentDir separately first.
+It also tells Pi to adopt unprepared repositories with `--gitignore user`, so
+the local store stays out of Git without changing project files. It does not
+install the `agentdir` CLI; install AgentDir separately first.
 
 ## Install
 
@@ -34,7 +36,7 @@ pi install git:github.com/jstxn/agentdir@<tag-or-commit>
 If the npm package has been published:
 
 ```bash
-pi install npm:@jstxn/agentdir-pi@0.7.7
+pi install npm:@jstxn/agentdir-pi@0.7.8
 ```
 
 Use `pi config` to enable or disable the bundled skill after installation.
@@ -48,7 +50,7 @@ The root `package.json` declares the Pi resources:
   "keywords": ["pi-package"],
   "pi": {
     "skills": ["./skills"],
-    "image": "https://raw.githubusercontent.com/jstxn/agentdir/v0.7.7/docs/assets/agentdir-overview.png"
+    "image": "https://raw.githubusercontent.com/jstxn/agentdir/v0.7.8/docs/assets/agentdir-overview.png"
   }
 }
 ```

{agentdir_cli-0.7.7 → agentdir_cli-0.7.8}/docs/RELEASING.md

@@ -31,9 +31,9 @@ chmod +x dist/rollback-agentdir.sh
 Expected assets (substitute the release version):
 
 ```text
-dist/agentdir_cli-0.7.7-py3-none-any.whl
-dist/agentdir_cli-0.7.7.tar.gz
-dist/jstxn-agentdir-pi-0.7.7.tgz
+dist/agentdir_cli-0.7.8-py3-none-any.whl
+dist/agentdir_cli-0.7.8.tar.gz
+dist/jstxn-agentdir-pi-0.7.8.tgz
 dist/install-agentdir.sh
 dist/rollback-agentdir.sh
 ```
@@ -41,19 +41,19 @@ dist/rollback-agentdir.sh
 ## Tag And Release
 
 ```bash
-git tag -a v0.7.7 -m "Release AgentDir v0.7.7"
+git tag -a v0.7.8 -m "Release AgentDir v0.7.8"
 git push origin main
-git push origin v0.7.7
+git push origin v0.7.8
 
-gh release create v0.7.7 \
-  dist/agentdir_cli-0.7.7-py3-none-any.whl \
-  dist/agentdir_cli-0.7.7.tar.gz \
-  dist/jstxn-agentdir-pi-0.7.7.tgz \
+gh release create v0.7.8 \
+  dist/agentdir_cli-0.7.8-py3-none-any.whl \
+  dist/agentdir_cli-0.7.8.tar.gz \
+  dist/jstxn-agentdir-pi-0.7.8.tgz \
   dist/install-agentdir.sh \
   dist/rollback-agentdir.sh \
   --repo jstxn/agentdir \
-  --title "AgentDir v0.7.7" \
-  --notes-file docs/releases/v0.7.7.md
+  --title "AgentDir v0.7.8" \
+  --notes-file docs/releases/v0.7.8.md
 ```
 
 Publishing the release triggers `publish.yml`, which rebuilds the sdist and
@@ -65,7 +65,7 @@ Use a disposable environment:
 
 ```bash
 tmp="$(mktemp -d)"
-gh release download v0.7.7 --repo jstxn/agentdir --pattern install-agentdir.sh --dir "$tmp"
+gh release download v0.7.8 --repo jstxn/agentdir --pattern install-agentdir.sh --dir "$tmp"
 AGENTDIR_PREFIX="$tmp/prefix" AGENTDIR_HOME="$tmp/home" bash "$tmp/install-agentdir.sh"
 "$tmp/prefix/bin/agentdir" --help
 "$tmp/prefix/bin/agentdir" --version
@@ -79,7 +79,7 @@ mkdir -p "$repo"
 git -C "$repo" init
 printf 'release smoke\n' > "$tmp/body.txt"
 cd "$repo"
-"$tmp/prefix/bin/agentdir" adopt --install-skill store
+"$tmp/prefix/bin/agentdir" adopt --install-skill store --gitignore user
 "$tmp/prefix/bin/agentdir" work start "release smoke" --emit-context
 "$tmp/prefix/bin/agentdir" run -- python3 -c "print('release smoke')"
 "$tmp/prefix/bin/agentdir" context build "release smoke"
@@ -101,13 +101,13 @@ tmp="$(mktemp -d)"
 AGENTDIR_PREFIX="$tmp/prefix" \
 AGENTDIR_HOME="$tmp/home" \
 AGENTDIR_FORCE_VENV=1 \
-AGENTDIR_WHEEL="$PWD/dist/agentdir_cli-0.7.7-py3-none-any.whl" \
+AGENTDIR_WHEEL="$PWD/dist/agentdir_cli-0.7.8-py3-none-any.whl" \
   bash dist/install-agentdir.sh
 
 AGENTDIR_PREFIX="$tmp/prefix" \
 AGENTDIR_HOME="$tmp/home" \
 AGENTDIR_FORCE_VENV=1 \
-  bash dist/rollback-agentdir.sh v0.7.6
+  bash dist/rollback-agentdir.sh v0.7.7
 
 "$tmp/prefix/bin/agentdir" --help
 ```

agentdir_cli-0.7.8/docs/releases/v0.7.8.md

@@ -0,0 +1,50 @@
+# AgentDir v0.7.8
+
+AgentDir v0.7.8 removes a common first-run annoyance by teaching coding agents
+to keep the local `.agentdir/` store out of Git automatically.
+
+## Changes
+
+- Update generated Codex, generic, Claude, Copilot, Cursor, Windsurf, rulesync,
+  and Pi guidance to adopt repositories with `agentdir adopt --gitignore user`.
+- Keep plain interactive adoption and all existing
+  `--gitignore ask|project|user|none` choices backward compatible.
+- Make the release installer print the recommended user-level adoption command
+  and the project/none alternatives without silently editing Git configuration.
+- Add regression coverage for every generated guidance surface, the Pi package,
+  rulesync, and installer messaging.
+
+## Install Or Update
+
+Install from PyPI:
+
+```bash
+uv tool install agentdir-cli
+# or
+pipx install agentdir-cli
+```
+
+Update an existing installation:
+
+```bash
+agentdir update
+```
+
+Or use the release installer:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/jstxn/agentdir/main/scripts/install.sh | bash
+```
+
+Install the Pi package from npm or the release tag:
+
+```bash
+pi install npm:@jstxn/agentdir-pi@0.7.8
+pi install git:github.com/jstxn/agentdir@v0.7.8
+```
+
+Rollback to v0.7.7 with:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/jstxn/agentdir/main/scripts/rollback.sh | bash
+```

{agentdir_cli-0.7.7 → agentdir_cli-0.7.8}/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jstxn/agentdir-pi",
-  "version": "0.7.7",
+  "version": "0.7.8",
   "description": "Pi package for AgentDir local-first coding-agent memory and evidence capture.",
   "license": "MIT",
   "keywords": [
@@ -29,6 +29,6 @@
     "skills": [
       "./skills"
     ],
-    "image": "https://raw.githubusercontent.com/jstxn/agentdir/v0.7.7/docs/assets/agentdir-overview.png"
+    "image": "https://raw.githubusercontent.com/jstxn/agentdir/v0.7.8/docs/assets/agentdir-overview.png"
   }
 }

{agentdir_cli-0.7.7 → agentdir_cli-0.7.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "agentdir-cli"
-version = "0.7.7"
+version = "0.7.8"
 description = "Local-first Maildir-inspired work mailstore for software agents"
 readme = "README.md"
 requires-python = ">=3.11"

{agentdir_cli-0.7.7 → agentdir_cli-0.7.8}/scripts/install.sh

@@ -1,7 +1,7 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
-AGENTDIR_VERSION="${AGENTDIR_VERSION:-v0.7.7}"
+AGENTDIR_VERSION="${AGENTDIR_VERSION:-v0.7.8}"
 AGENTDIR_REPO="${AGENTDIR_REPO:-jstxn/agentdir}"
 AGENTDIR_PACKAGE_VERSION="${AGENTDIR_VERSION#v}"
 # Releases after v0.7.4 ship the wheel under the agentdir-cli distribution
@@ -151,6 +151,8 @@ main() {
     fail "agentdir executable was not found on PATH after pipx install"
   fi
   log "installed AgentDir $AGENTDIR_VERSION"
+  log "next: from a repository, run: agentdir adopt --gitignore user"
+  log "use --gitignore project for a repo-local rule, or --gitignore none to leave ignore files unchanged"
 }
 
 main "$@"

{agentdir_cli-0.7.7 → agentdir_cli-0.7.8}/scripts/rollback.sh

@@ -2,7 +2,7 @@
 set -euo pipefail
 
 AGENTDIR_REPO="${AGENTDIR_REPO:-jstxn/agentdir}"
-AGENTDIR_ROLLBACK_VERSION="${1:-${AGENTDIR_ROLLBACK_VERSION:-v0.7.6}}"
+AGENTDIR_ROLLBACK_VERSION="${1:-${AGENTDIR_ROLLBACK_VERSION:-v0.7.7}}"
 AGENTDIR_TMP_DIR=""
 
 log() {

{agentdir_cli-0.7.7 → agentdir_cli-0.7.8}/skills/agentdir/SKILL.md

@@ -21,7 +21,7 @@ This Pi package teaches Pi how to operate AgentDir. It does not install the `age
 
 At the start of a non-trivial coding task in a software repository:
 
-1. If `.agentdir` is missing, run `agentdir adopt` once before work begins.
+1. If `.agentdir` is missing, run `agentdir adopt --gitignore user` once so the local store stays out of Git without changing the repository's `.gitignore`.
 2. Start the session with `agentdir work start "<short task>" --emit-context`.
 3. Keep any returned context pack id/source ids if you plan to cite or consume retrieved context later.
 

{agentdir_cli-0.7.7 → agentdir_cli-0.7.8}/src/agentdir/__init__.py

@@ -1,3 +1,3 @@
 """AgentDir local agent work mailstore."""
 
-__version__ = "0.7.7"
+__version__ = "0.7.8"

{agentdir_cli-0.7.7 → agentdir_cli-0.7.8}/src/agentdir/skills.py

@@ -35,7 +35,9 @@ user when reporting evidence, blockers, or setup problems.
 ## Start
 
 - At the start of a coding task in a repository, run `agentdir work start "<short task>" --emit-context`.
-- If `.agentdir` is missing and the task is non-trivial, run `agentdir adopt` once for the repository before work begins.
+- If `.agentdir` is missing and the task is non-trivial, run
+  `agentdir adopt --gitignore user` once so the local store stays out of Git
+  without changing the repository's `.gitignore`.
 - Prefer the default project store. It writes to the nearest repo `.agentdir`.
 - Do not record secrets, private keys, raw environment dumps, or credential-bearing command output.
 - If `doctor` reports secret-like persisted bodies, do not print the bodies.
@@ -103,7 +105,8 @@ The engineer should not have to run AgentDir commands during normal coding work.
 The agent owns the background recording flow:
 
 - Start non-trivial coding work with `agentdir work start "<short task>" --emit-context`.
-- If `.agentdir` is missing, run `agentdir adopt` once before work begins.
+- If `.agentdir` is missing, run `agentdir adopt --gitignore user` once so the
+  local store stays out of Git without changing the repository's `.gitignore`.
 - Run evidence-bearing commands through `agentdir run -- <command>`.
 - Evidence-bearing commands include tests, lint, typecheck, build, release checks,
   reproduced failures, and diagnostics that support final claims.
@@ -697,7 +700,7 @@ GUIDANCE_BODY = """AgentDir is agent-owned background instrumentation for this r
 The engineer installs or adopts it once; agents operate it during normal work.
 
 - Start non-trivial coding work with `agentdir work start "<short task>" --emit-context`.
-- If `.agentdir` is missing, run `agentdir adopt` once before starting.
+- If `.agentdir` is missing, run `agentdir adopt --gitignore user` once so the local store stays out of Git without changing the repository's `.gitignore`.
 - Wrap evidence-bearing commands with `agentdir run -- <command>`.
 - Evidence includes tests, lint, typecheck, builds, doctor checks, release checks, reproduced failures, and diagnostics used in final claims.
 - Do not wrap routine exploration such as `rg`, `sed`, `nl`, `cat`, `ls`, `find`, or quick read-only `git status`.

{agentdir_cli-0.7.7 → agentdir_cli-0.7.8/src/agentdir_cli.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agentdir-cli
-Version: 0.7.7
+Version: 0.7.8
 Summary: Local-first Maildir-inspired work mailstore for software agents
 Author: AgentDir Contributors
 License-Expression: MIT
@@ -128,7 +128,8 @@ curl -fsSL https://raw.githubusercontent.com/jstxn/agentdir/main/scripts/install
 
 The installer uses `pipx` when available. Otherwise it creates a self-contained
 virtual environment under `~/.local/share/agentdir` and links the CLI into
-`~/.local/bin`.
+`~/.local/bin`. It does not edit Git configuration or ignore files; after
+installation it prints the explicit adoption choices.
 
 Verify:
 
@@ -155,7 +156,7 @@ available automatically during coding tasks:
 Package page: [@jstxn/agentdir-pi](https://pi.dev/packages/@jstxn/agentdir-pi)
 
 ```bash
-pi install npm:@jstxn/agentdir-pi@0.7.7
+pi install npm:@jstxn/agentdir-pi@0.7.8
 # or install directly from a local checkout / release tag:
 pi install /absolute/path/to/agentdir
 pi install git:github.com/jstxn/agentdir@<tag-or-commit>
@@ -174,6 +175,13 @@ Run once from a git repository:
 agentdir adopt
 ```
 
+Coding agents use the non-interactive form below so `.agentdir/` is ignored at
+the user level without creating a repository `.gitignore` change:
+
+```bash
+agentdir adopt --gitignore user
+```
+
 This is intentionally boring setup. It prepares the repository once, then agents
 operate AgentDir during normal coding work:
 
@@ -219,6 +227,10 @@ agentdir adopt --gitignore user     # write the user-level Git excludes file
 agentdir adopt --gitignore none     # leave ignore files unchanged
 ```
 
+Generated AgentDir guidance selects `--gitignore user` by default. The plain
+interactive command still prompts, and all three explicit choices remain
+available.
+
 Undo managed setup while keeping the `.agentdir` evidence store:
 
 ```bash

{agentdir_cli-0.7.7 → agentdir_cli-0.7.8}/src/agentdir_cli.egg-info/SOURCES.txt

@@ -35,6 +35,7 @@ docs/releases/v0.7.4.md
 docs/releases/v0.7.5.md
 docs/releases/v0.7.6.md
 docs/releases/v0.7.7.md
+docs/releases/v0.7.8.md
 examples/dogfood-session.sh
 scripts/install.sh
 scripts/rollback.sh
@@ -82,6 +83,7 @@ tests/test_agent_first.py
 tests/test_agent_trust.py
 tests/test_audit.py
 tests/test_environment.py
+tests/test_install_script.py
 tests/test_pi_package.py
 tests/test_truncation.py
 tests/test_v1_behavior.py

{agentdir_cli-0.7.7 → agentdir_cli-0.7.8}/tests/test_agent_first.py

@@ -69,7 +69,7 @@ def query_rows(root: Path, event_type: str | None = None) -> list[dict[str, obje
 def test_cli_version_reports_package_version() -> None:
     result = run_cli("--version")
 
-    assert result.stdout.strip() == "agentdir 0.7.7"
+    assert result.stdout.strip() == "agentdir 0.7.8"
 
 
 def test_session_current_and_sessionless_emit_use_project_store(tmp_path: Path) -> None:
@@ -322,6 +322,7 @@ def test_setup_installs_hooks_and_user_codex_skill(tmp_path: Path) -> None:
     assert skill_path.is_file()
     skill_text = skill_path.read_text(encoding="utf-8")
     assert "The user should not have to run AgentDir commands during normal coding work." in skill_text
+    assert "agentdir adopt --gitignore user" in skill_text
     assert 'agentdir work start "<short task>" --emit-context' in skill_text
     assert "agentdir status" in skill_text
     assert "agentdir run -- <command>" in skill_text
@@ -566,6 +567,24 @@ def test_integrations_project_rerun_is_byte_stable_for_managed_only_files(tmp_pa
     assert all(item["updated"] is False for item in json.loads(rerun.stdout))
 
 
+def test_generated_agent_guidance_uses_user_gitignore(tmp_path: Path) -> None:
+    repo = init_repo(tmp_path / "repo")
+
+    run_cli("integrations", "install", "all", "--target", "project", "--json", cwd=repo)
+
+    guidance_paths = [
+        repo / "AGENTS.md",
+        repo / ".agents" / "skills" / "agentdir" / "SKILL.md",
+        repo / "CLAUDE.md",
+        repo / ".github" / "copilot-instructions.md",
+        repo / ".cursor" / "rules" / "agentdir.mdc",
+        repo / ".windsurf" / "rules" / "agentdir.md",
+    ]
+    for path in guidance_paths:
+        text = path.read_text(encoding="utf-8")
+        assert "agentdir adopt --gitignore user" in text, path
+
+
 def test_integrations_install_all_store_target(tmp_path: Path) -> None:
     repo = init_repo(tmp_path / "repo")
 

{agentdir_cli-0.7.7 → agentdir_cli-0.7.8}/tests/test_environment.py

@@ -89,6 +89,7 @@ def test_adopt_redirects_integrations_to_rulesync_source_rule(tmp_path: Path) ->
     assert 'targets: ["*"]' in rule_text
     assert "<!-- agentdir-managed-rulesync:start -->" in rule_text
     assert "agentdir work start" in rule_text
+    assert "agentdir adopt --gitignore user" in rule_text
     assert not (repo / "CLAUDE.md").exists()
     assert not (repo / "AGENTS.md").exists()
     assert not (repo / ".cursor").exists()

agentdir_cli-0.7.8/tests/test_install_script.py

@@ -0,0 +1,14 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+
+ROOT = Path(__file__).resolve().parents[1]
+
+
+def test_installer_prints_safe_gitignore_choices() -> None:
+    text = (ROOT / "scripts" / "install.sh").read_text(encoding="utf-8")
+
+    assert "agentdir adopt --gitignore user" in text
+    assert "--gitignore project" in text
+    assert "--gitignore none" in text

{agentdir_cli-0.7.7 → agentdir_cli-0.7.8}/tests/test_pi_package.py

@@ -12,11 +12,11 @@ def test_pi_package_manifest_points_to_agentdir_skill() -> None:
     package = json.loads((ROOT / "package.json").read_text(encoding="utf-8"))
 
     assert package["name"] == "@jstxn/agentdir-pi"
-    assert package["version"] == "0.7.7"
+    assert package["version"] == "0.7.8"
     assert "pi-package" in package["keywords"]
     assert package["pi"] == {
         "skills": ["./skills"],
-        "image": "https://raw.githubusercontent.com/jstxn/agentdir/v0.7.7/docs/assets/agentdir-overview.png",
+        "image": "https://raw.githubusercontent.com/jstxn/agentdir/v0.7.8/docs/assets/agentdir-overview.png",
     }
     assert "skills" in package["files"]
     assert "docs/PI_PACKAGE.md" in package["files"]
@@ -35,5 +35,6 @@ def test_agentdir_pi_skill_frontmatter_and_workflow() -> None:
     assert len(description.group(1)) <= 1024
     assert re.search(r"^compatibility: ", frontmatter, re.MULTILINE)
     assert "agentdir work start" in text
+    assert "agentdir adopt --gitignore user" in text
     assert "agentdir run --" in text
     assert "agentdir work finish --json" in text