GEO Wiki CLI

AI Agent & Developer Command-Line Tool

English | 中文

GEO Wiki Pro is a paid product. Visit geowiki.pro to explore features — our website IS the product. For purchase or enterprise deployment, contact: [email protected]

Installation

npm install -g geowiki-cli

Verify:

geo --version

Quick Start

1. Login

geo login --url https://your-site.com --user admin --pass YourPassword

2. Check Status

geo status

3. List Documents

geo doc list
geo doc list --json          # JSON output (for agents)
geo doc list --category cli  # Filter by category

Commands

Authentication

| Command | Description | |---------|-------------| | geo login --url URL --user USER --pass PASS | Login and save session | | geo logout | Clear saved credentials | | geo status | Show connection status |

Document Management

| Command | Description | |---------|-------------| | geo doc list | List all documents | | geo doc list --category SLUG | Filter by category | | geo doc list --lang en | Specify language | | geo doc get --slug SLUG | Get document content | | geo doc create --file FILE --category CAT | Create from file | | geo doc create --title "Title" --slug SLUG --content "..." | Create with inline content | | geo doc update --slug SLUG --file FILE | Update from file | | geo doc update --slug SLUG --content "New content" | Update content | | geo doc update --slug SLUG --title "New title" | Update title | | geo doc update --slug SLUG --description "Desc" | Update description | | geo doc update --slug SLUG --author "Name" | Update author | | geo doc update --slug SLUG --tags "tag1,tag2" | Update tags | | geo doc update --slug SLUG --notice "Notice" | Update notice | | geo doc update --slug SLUG --sort 2 | Update sort order | | geo doc delete --slug SLUG | Delete (move to trash) | | geo doc delete --slug SLUG --yes | Skip confirmation | | geo doc trash | View trash | | geo doc trash --clear | Empty trash | | geo doc recover --file FILE | Recover from trash | | geo doc reorder --orders "slug1:0,slug2:1" | Batch reorder |

Examples:

# Create from file
geo doc create --file ./product.md --category products --slug product-a

# Create with language
geo doc create --file ./product-en.md --category products --slug product-a --lang en

# Create with tags
geo doc create --file ./guide.md --category docs --tags "guide,tutorial"

# Create with inline content
geo doc create --title "Title" --category docs --slug my-doc --content "# Body content"

# Update title and description
geo doc update --slug my-doc --title "New Title" --description "New desc" --lang zh

# Update author and tags
geo doc update --slug my-doc --author "John" --tags "product,v2" --lang zh

# Update notice
geo doc update --slug my-doc --notice "This doc has been updated" --lang zh

Category Management

| Command | Description | |---------|-------------| | geo category list | List categories | | geo category create --name "Name" --slug SLUG | Create category | | geo category create --name "Name" --name-en "Name" --slug SLUG | Create with English name | | geo category update --slug SLUG --name "New Name" | Update category | | geo category delete --slug SLUG | Delete category |

Tag Management

| Command | Description | |---------|-------------| | geo tag list | List tags | | geo tag create --name "Name" --slug SLUG | Create tag | | geo tag delete --slug SLUG | Delete tag |

Media Management

| Command | Description | |---------|-------------| | geo media list | List root files | | geo media list --dir DIR | List subdirectory | | geo media tree | Show directory tree | | geo media upload --file FILE | Upload file | | geo media upload --file FILE --directory DIR | Upload to subdirectory | | geo media mkdir --name NAME | Create folder | | geo media mkdir --name NAME --parent PARENT | Create in subdirectory | | geo media rmdir --path PATH | Delete empty folder | | geo media move --source SRC --target DIR | Move file | | geo media delete --file FILE | Delete file |

Examples:

# Upload image to subdirectory
geo media upload --file ./photo.jpg --directory products

# Create nested folder
geo media mkdir --name images --parent products

# Move file
geo media move --source temp/photo.jpg --target products/images

# View directory structure
geo media tree

User Management

| Command | Description | |---------|-------------| | geo user list | List users | | geo user create --user NAME --pass PASS --role admin | Create user | | geo user update --user NAME --role editor | Update role | | geo user delete --user NAME | Delete user | | geo user reset-password --user NAME --pass NEWPASS | Reset password |

Site Configuration

| Command | Description | |---------|-------------| | geo config get | Get config | | geo config get --json | Get as JSON | | geo config update --hero-title "Title" | Update hero title | | geo config update --logo-url "/media/logo.png" | Update logo | | geo config update --favicon-url "/media/favicon.ico" | Update favicon | | geo config update --featured-slugs "slug1,slug2" | Set featured docs |

Draft Management

| Command | Description | |---------|-------------| | geo draft list | List drafts | | geo draft get --slug SLUG | Get draft | | geo draft publish --slug SLUG | Publish draft | | geo draft delete --slug SLUG | Delete draft |

Search

geo search "keyword"
geo search "CAN bus" --category products
geo search "protocol" --lang en --json

Statistics

geo stats
geo stats --json

Feedback Management

| Command | Description | |---------|-------------| | geo feedback list | List feedback | | geo feedback delete --id ID | Delete feedback | | geo feedback promote --id ID | Promote to comment |

Guestbook

| Command | Description | |---------|-------------| | geo guestbook list | List messages | | geo guestbook toggle | Toggle guestbook | | geo guestbook update --id ID --status approved | Approve message | | geo guestbook delete --id ID | Delete message |

GEO Optimization

| Command | Description | |---------|-------------| | geo geo status | GEO status | | geo geo report | GEO report | | geo geo rebuild | Rebuild llms.txt & sitemap |

AI Agent Usage

All commands support --json output:

# Agent: list docs
geo doc list --json

# Agent: search
geo search "CAN bus protocol" --json

# Agent: create doc
geo doc create --file ./content.md --category products --slug new-product --json

# Agent: upload image
geo media upload --file ./diagram.png --directory products --json

Agent Workflow Example

# 1. Get categories
geo category list --json

# 2. Create document
geo doc create --file ./article.md --category tech --slug my-article

# 3. Upload image
geo media upload --file ./image.png --directory tech

# 4. Verify
geo doc get --slug my-article --json

Environment Variables

| Variable | Description | Default | |----------|-------------|---------| | GEO_URL | Site URL | — | | GEO_TOKEN | API Token | — |

Login with API Token (for CI/CD):

geo login --url https://your-site.com --token geo_xxxxxxxxxxxx

FAQ

Login Failed

# Check connection
geo status

# Re-login
geo login --url https://your-site.com --user admin --pass YourPassword

Permission Denied

Ensure user has admin or editor role:

geo user list --json

Upload Failed

Check file size (max 50MB) and type:

geo media upload --file ./large-file.zip
# Error: File too large, max 50MB

Development

git clone https://github.com/your-org/geowiki-pro.git
cd geowiki-pro
npm install
node bin/geo.js --help

License

MIT © GEO Wiki Pro

中文

AI Agent 与开发者的命令行管理工具

GEO Wiki CLI 是 GEO Wiki Pro 的命令行工具，专为 AI Agent 和开发者设计，可通过命令行管理知识库的所有内容。

GEO Wiki Pro 是付费产品，欢迎访问 geowiki.pro 了解功能——官网即产品。如需购买或企业部署，请联系：[email protected]

安装

npm install -g geowiki-cli

验证安装：

geo --version

快速开始

1. 登录

geo login --url https://your-site.com --user admin --pass YourPassword

2. 查看状态

geo status

3. 列出文档

geo doc list
geo doc list --json          # JSON 格式（供 Agent 使用）
geo doc list --category cli  # 按分类筛选

命令参考

认证

| 命令 | 说明 | |------|------| | geo login --url URL --user USER --pass PASS | 登录并保存会话 | | geo logout | 清除保存的凭据 | | geo status | 显示当前连接状态 |

文档管理

| 命令 | 说明 | |------|------| | geo doc list | 列出所有文档 | | geo doc list --category SLUG | 按分类筛选 | | geo doc list --lang en | 指定语言 | | geo doc get --slug SLUG | 获取文档内容 | | geo doc create --file FILE --category CAT | 从文件创建 | | geo doc create --title "标题" --slug SLUG --content "..." | 直接传内容创建 | | geo doc update --slug SLUG --file FILE | 从文件更新 | | geo doc update --slug SLUG --content "新内容" | 更新内容 | | geo doc update --slug SLUG --title "新标题" | 更新标题 | | geo doc update --slug SLUG --description "描述" | 更新描述 | | geo doc update --slug SLUG --author "作者" | 更新作者 | | geo doc update --slug SLUG --tags "tag1,tag2" | 更新标签 | | geo doc update --slug SLUG --notice "通知" | 更新通知 | | geo doc update --slug SLUG --sort 2 | 更新排序 | | geo doc delete --slug SLUG | 删除（移到回收站） | | geo doc delete --slug SLUG --yes | 跳过确认删除 | | geo doc trash | 查看回收站 | | geo doc trash --clear | 清空回收站 | | geo doc recover --file FILE | 恢复文档 | | geo doc reorder --orders "slug1:0,slug2:1" | 批量排序 |

创建文档示例：

# 从文件创建
geo doc create --file ./product.md --category products --slug product-a

# 指定语言
geo doc create --file ./product-en.md --category products --slug product-a --lang en

# 带标签
geo doc create --file ./guide.md --category docs --tags "guide,tutorial"

# 直接传内容（无需文件）
geo doc create --title "标题" --category docs --slug my-doc --content "# 正文内容"

更新文档示例：

# 更新标题和描述
geo doc update --slug my-doc --title "新标题" --description "新描述" --lang zh

# 更新作者和标签
geo doc update --slug my-doc --author "张三" --tags "产品,v2" --lang zh

# 更新通知
geo doc update --slug my-doc --notice "本文档已更新" --lang zh

分类管理

| 命令 | 说明 | |------|------| | geo category list | 列出所有分类 | | geo category create --name "名称" --slug SLUG | 创建分类 | | geo category create --name "名称" --name-en "Name" --slug SLUG | 创建分类（含英文名） | | geo category update --slug SLUG --name "新名称" | 更新分类 | | geo category delete --slug SLUG | 删除分类 |

标签管理

| 命令 | 说明 | |------|------| | geo tag list | 列出所有标签 | | geo tag create --name "名称" --slug SLUG | 创建标签 | | geo tag delete --slug SLUG | 删除标签 |

媒体管理

| 命令 | 说明 | |------|------| | geo media list | 列出根目录文件 | | geo media list --dir DIR | 列出子目录文件 | | geo media tree | 显示目录树 | | geo media upload --file FILE | 上传文件 | | geo media upload --file FILE --directory DIR | 上传到子目录 | | geo media mkdir --name NAME | 创建文件夹 | | geo media mkdir --name NAME --parent PARENT | 在子目录创建文件夹 | | geo media rmdir --path PATH | 删除空文件夹 | | geo media move --source SRC --target DIR | 移动文件 | | geo media delete --file FILE | 删除文件 |

媒体操作示例：

# 上传图片到子目录
geo media upload --file ./photo.jpg --directory products

# 创建嵌套文件夹
geo media mkdir --name images --parent products

# 移动文件
geo media move --source temp/photo.jpg --target products/images

# 查看目录结构
geo media tree

用户管理

| 命令 | 说明 | |------|------| | geo user list | 列出所有用户 | | geo user create --user NAME --pass PASS --role admin | 创建用户 | | geo user update --user NAME --role editor | 更新用户角色 | | geo user delete --user NAME | 删除用户 | | geo user reset-password --user NAME --pass NEWPASS | 重置密码 |

站点配置

| 命令 | 说明 | |------|------| | geo config get | 获取配置 | | geo config get --json | JSON 格式获取 | | geo config update --hero-title "标题" | 更新首页标题 | | geo config update --logo-url "/media/logo.png" | 更新 Logo | | geo config update --favicon-url "/media/favicon.ico" | 更新 Favicon | | geo config update --featured-slugs "slug1,slug2" | 设置推荐文档 |

草稿管理

| 命令 | 说明 | |------|------| | geo draft list | 列出草稿 | | geo draft get --slug SLUG | 获取草稿 | | geo draft publish --slug SLUG | 发布草稿 | | geo draft delete --slug SLUG | 拒绝/删除草稿 |

搜索

geo search "关键词"
geo search "CAN bus" --category products
geo search "protocol" --lang en --json

统计

geo stats
geo stats --json

反馈管理

| 命令 | 说明 | |------|------| | geo feedback list | 列出反馈 | | geo feedback delete --id ID | 删除反馈 | | geo feedback promote --id ID | 提升为评论 |

留言板

| 命令 | 说明 | |------|------| | geo guestbook list | 列出留言 | | geo guestbook toggle | 开关留言板 | | geo guestbook update --id ID --status approved | 审核留言 | | geo guestbook delete --id ID | 删除留言 |

GEO 优化

| 命令 | 说明 | |------|------| | geo geo status | GEO 状态概览 | | geo geo report | GEO 详细报告 | | geo geo rebuild | 重建 llms.txt 和 sitemap |

AI Agent 使用指南

GEO Wiki CLI 专为 AI Agent 设计，所有命令都支持 --json 输出：

# Agent 获取文档列表
geo doc list --json

# Agent 搜索文档
geo search "CAN bus protocol" --json

# Agent 创建文档
geo doc create --file ./content.md --category products --slug new-product --json

# Agent 上传图片
geo media upload --file ./diagram.png --directory products --json

Agent 工作流示例

# 1. 获取所有分类
geo category list --json

# 2. 创建文档
geo doc create --file ./article.md --category tech --slug my-article

# 3. 上传相关图片
geo media upload --file ./image.png --directory tech

# 4. 验证创建成功
geo doc get --slug my-article --json

环境变量

| 变量 | 说明 | 默认值 | |------|------|--------| | GEO_URL | 站点 URL | — | | GEO_TOKEN | API Token | — |

使用 API Token 登录（适合 CI/CD）：

geo login --url https://your-site.com --token geo_xxxxxxxxxxxx

常见问题

登录失败

# 检查连接
geo status

# 重新登录
geo login --url https://your-site.com --user admin --pass YourPassword

权限不足

确保用户有 admin 或 editor 角色：

geo user list --json

文件上传失败

检查文件大小（默认最大 50MB）和文件类型：

geo media upload --file ./large-file.zip
# Error: 文件过大，最大支持 50MB

开发

git clone https://github.com/your-org/geowiki-pro.git
cd geowiki-pro
npm install
node bin/geo.js --help

License

MIT © GEO Wiki Pro