Add automated cross-project agent setup

[ZimoLiao]

Summary

Cross-project ScholarAIO setup no longer requires users to manually stitch together shell exports, skill symlinks, and host-specific wrapper files. scholaraio setup agent now previews the full integration plan, applies the parts that are safe to automate, and clearly separates Codex/OpenClaw global discovery from Claude plugin installation and project-local host wrappers.

Behavior By Host

Host	What the setup flow does
Codex / OpenClaw	Creates or verifies the global ~/.agents/skills/scholaraio link to the canonical ScholarAIO skills tree, plus shell runtime wiring.
Claude Code	Prints the required plugin slash-commands as manual actions instead of pretending a shell command can install them.
Qwen / Cursor / Cline / Windsurf / Copilot	Creates project-local wrapper files when --target-project is supplied, with explicit warnings that those blocks contain local machine paths.

Design Notes

• The setup flow is plan-first: preview, check, and apply all render the same action model so users can inspect changes before writing to shell or project files.
• Managed blocks keep edits bounded in user-owned files such as shell rc files and project wrapper docs.
• Manual work is rendered as [manual], not [OK], so diagnostics do not imply a host is configured when user action is still required.
• Documentation now points users to the automated path while preserving the manual fallback for restricted environments.

Verification

• python -m pytest -q -p no:cacheprovider
• python -m pytest -q -p no:cacheprovider tests/test_agent_setup.py tests/test_cli_messages.py::TestCliHelpLocalization tests/test_writing_docs_alignment.py
• python -m ruff check scholaraio tests
• python -m ruff format --check scholaraio tests
• python -m mkdocs build --strict
• git diff --check
• CLI smoke for setup agent --agent claude --no-shell, setup agent --help, and setup agent --all --target-project /tmp/... --no-shell

---

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 6823e35537

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".