{"id":51163538,"url":"https://github.com/ronny1020/ai-agent-press","last_synced_at":"2026-06-26T16:31:04.013Z","repository":{"id":358397124,"uuid":"1240523795","full_name":"ronny1020/ai-agent-press","owner":"ronny1020","description":"Beautiful, automated AI Agent documentation portal generator. Organize rules, skills, and agents into a professional VitePress site.","archived":false,"fork":false,"pushed_at":"2026-05-26T16:17:36.000Z","size":171,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-05-26T17:17:58.545Z","etag":null,"topics":["agentic-workflows","ai-agents","automation","documentation","vitepress"],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ronny1020.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-16T08:32:09.000Z","updated_at":"2026-05-17T14:26:00.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/ronny1020/ai-agent-press","commit_stats":null,"previous_names":["ronny1020/ai-agent-press"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/ronny1020/ai-agent-press","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ronny1020%2Fai-agent-press","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ronny1020%2Fai-agent-press/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ronny1020%2Fai-agent-press/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ronny1020%2Fai-agent-press/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ronny1020","download_url":"https://codeload.github.com/ronny1020/ai-agent-press/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ronny1020%2Fai-agent-press/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34825610,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-26T02:00:06.560Z","response_time":106,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic-workflows","ai-agents","automation","documentation","vitepress"],"created_at":"2026-06-26T16:31:03.142Z","updated_at":"2026-06-26T16:31:04.008Z","avatar_url":"https://github.com/ronny1020.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ai-agent-press 🚀\n\n**ai-agent-press** is a zero-config, **Bun-powered** CLI tool that transforms AI agent ecosystem files into searchable documentation portals and structured content graphs.\n\nTurn your AI-agent instruction files and config directories into a unified developer portal or a hierarchical JSON stream in seconds.\n\n## ✨ Features\n\n- **Filesystem-first**: Scans your repo for AI-agent-related files automatically.\n- **Bun-powered**: Native speed and built-in testing with `bun test`.\n- **Hierarchical Navigation**: Strictly organized sidebar and URLs (`/{scope}/{ecosystem}/{category}/{name}`).\n- **Smart Flattening**: Automatically simplifies the sidebar structure when only one scope or ecosystem is present.\n- **Headless Mode**: List agent configurations as a hierarchical JSON tree that matches the portal sidebar.\n- **Zero-config**: No manual VitePress scaffolding or repo pollution.\n- **Ecosystem-aware**: Supports OpenAI, Claude, Gemini, Cursor, Agent, Codex, Cline, Roo, and OpenClaw.\n- **Global-first**: Simultaneously loads local repo and global (`~/.agents`, etc.) instructions by default.\n\n## 🚀 Quick Start\n\n### Installation\n```bash\nbun add -g ai-agent-press\n```\n\n### Usage\n```bash\n# Start a documentation portal (default preview mode)\npress\n\n# Preview a specific project or multiple roots\npress ../my-project -p 3000\npress preview ./repo-a ./repo-b --port 5000\n\n# Build a static documentation site (output to .press/dist)\npress build\npress build ./repo-a --outDir .press/repo-a\n\n# Headless: List all discovered agents as a hierarchical JSON tree\npress list --json\n\n# Filter to one or more ecosystems\npress list --claude --json\npress preview --gemini --cursor\npress list --all --json\n```\n\n## 🛠 Commands \u0026 Flags\n\n- `press`: Start local documentation server in preview mode.\n- `press preview`: Start local documentation server.\n- `press build`: Generate static documentation site.\n- `press list`: List agent files in a hierarchical structure (Headless mode).\n- `press validate`: Validate ecosystem structures and content.\n- `press doctor`: Diagnostics and environment checks.\n\n### Global Options\n- `--global`: Include only global configurations from `~/.agents`, `~/.claude`, etc.\n- `--repo`: Include only configurations from the current repository.\n- `-p, --port \u003cport\u003e`: Choose the preview server port.\n- `--json`: Format output as JSON (for `list`).\n- `--openai`, `--claude`, `--gemini`, `--cursor`, `--codex`, `--cline`, `--roo`, `--openclaw`: Filter ecosystems.\n- `--all`: Include all ecosystems and categories (Skills, Rules, Workflows).\n- `-h, --help`: Display help information.\n\n## 🖥 Architecture \u0026 Display\n\n### Hierarchical Sidebar \u0026 URLs\nThe portal and headless output follow a strict hierarchy:\n1.  **Scope**: `Global` or `Current Repo` (omitted if only one exists).\n2.  **Ecosystem**: `gemini`, `claude`, etc. (omitted if only one exists).\n3.  **Category**: `instructions`, `agents`, `skills`, or `resources`.\n4.  **Name**: The slugified filename.\n\n**URL Example**: `/global/gemini/skills/github-pr`\n\n### Smart Flattening\nTo keep navigation clean, **ai-agent-press** automatically flattens layers:\n- If only local repo files are found, the top-level \"Current Repo\" section is hidden.\n- If only one ecosystem is active (e.g., via `--gemini`), the ecosystem layer is omitted.\n\n### Ecosystem Discovery\n- **OpenAI**: `OPENAI.md`, `.openai/`\n- **Agent**: `AGENTS.md`, `.agents/`\n- **Codex**: `CODEX.md`, `.codex/`\n- **Claude**: `CLAUDE.md`, `.claude/`\n- **Gemini**: `GEMINI.md`, `.gemini/`\n- **Cursor**: `.cursor/rules/`\n- **Cline**: `.cline/`, `.clinerules`\n- **Roo**: `.roo/`, `.roomodes`, `.roorules`\n- **OpenClaw**: `openclaw.json`, `openclaw.json5`, `.openclaw/`\n\n### Rendering Notes\n- `GEMINI.md` is the preferred portal homepage; `AGENTS.md` is the fallback.\n- Content is automatically wrapped in `\u003cdiv v-pre\u003e` to prevent VitePress from parsing agent instructions as Vue components.\n- Problematic system files (e.g., `models_cache.json`) are automatically excluded from rendering to ensure build stability.\n\n## 📂 Project Philosophy\n\n**ai-agent-press** aims to unify fragmented AI ecosystems into a single, searchable experience without repo pollution. All temporary files are stored in `node_modules/.ai-agent-press`, keeping your project clean.\n\n## 🤝 Contributing\n\nContributions are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) and [TESTING.md](TESTING.md) for details. **Note**: This project uses `bun` for all development and testing.\n\n## 📄 License\n\nMIT © [AI Agent Press Contributors](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fronny1020%2Fai-agent-press","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fronny1020%2Fai-agent-press","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fronny1020%2Fai-agent-press/lists"}