Expert guidance for interacting with the Weeko CLI - a Bun-powered, AI-native CLI for managing your Weeko bookmarks and groups.
The Weeko CLI provides command-line access to your Weeko bookmark manager with AI-friendly output formats. All commands support:
json (default) or toon (AI-optimized via --format toon) or pretty (formatted tables)--dry-runInstall from npm (recommended)
bun install -g weeko-cli
Verify installation:
weeko --version
# Authentication
weeko login [api-key] # Login with API key
weeko whoami # Show current user
weeko logout # Remove credentials
# Get context about the account
weeko status # Account overview (alias: context)
weeko tree # Show all groups (alias: structure)
# Search and manage bookmarks
weeko search "query" # Search bookmarks
weeko add <url> # Add new bookmark
weeko get <id> # Get bookmark details
weeko update <id> # Update bookmark
weeko delete <id> # Delete bookmark
weeko list # List all bookmarks
# Manage groups
weeko group list # List groups
weeko group create "Name" # Create group
weeko group update <id> # Update group
weeko group delete <id> # Delete group
# Batch operations
weeko batch move --ids "1,2,3" --group <id> # Move bookmarks
weeko batch delete --ids "1,2,3" # Delete bookmarks
weeko login # Interactive prompt
weeko login "wk_xxx" # Provide key directly
Getting an API key:
wk_)weeko whoami # Returns user ID, name, email
weeko status # High-level overview:
# - User details
# - Bookmark stats (total, links, colors, text, public)
# - Group count
# - Recent groups
weeko tree # All groups with IDs, names, and bookmark counts
weeko list # List all bookmarks
weeko list -g <groupId> # Filter by group ID
weeko list --pretty # Formatted table output
weeko search "query" # Search by title, URL, or description
weeko search "javascript" --pretty # Formatted results
Search is performed client-side across bookmark title, URL, and description fields.
weeko get <id> # Full bookmark details:
# - id, title, url, description
# - image, favicon, siteName
# - type (link/color/text)
# - color, isPublic, groupId
# - group info (id, name, color)
# - createdAt, updatedAt
weeko add "https://example.com"
weeko add "https://example.com" -t "My Title"
weeko add "https://example.com" -g <groupId>
weeko add "https://example.com" -t "Title" -g <groupId> -d "Description"
If no group is specified with -g, you'll be prompted to select one interactively.
Options:
-t, --title </code>: Bookmark title (prompts if not provided)</li><li><code>-g, --group <id></code>: Target group ID</li><li><code>-d, --description <desc></code>: Description</li></ul><h3>Update Bookmarks</h3><pre><code>weeko update <id> -t "New Title"
weeko update <id> -u "https://new-url.com"
weeko update <id> -g <newGroupId>
weeko update <id> -d "New description"
weeko update <id> -t "Title" -g <groupId> -d "Desc"
</code></pre><p><strong>Options:</strong></p><ul><li><code>-t, --title <title></code>: New title</li><li><code>-u, --url <url></code>: New URL</li><li><code>-g, --group <id></code>: Move to different group</li><li><code>-d, --description <desc></code>: New description</li></ul><p>All options are optional. Only provided fields will be updated.</p><h3>Delete Bookmarks</h3><pre><code>weeko delete <id> # Deletes after confirmation
</code></pre><h2>Working with Groups</h2><h3>List Groups</h3><pre><code>weeko group list # All groups with IDs and counts
weeko group list --pretty # Formatted table
</code></pre><h3>Get Group Details</h3><pre><code>weeko group get <id> # Full group details:
# - id, name, color
# - isPublic, bookmarkCount
# - createdAt, updatedAt
</code></pre><h3>Create Groups</h3><pre><code>weeko group create "My Group"
weeko group create "Work" -c "#ef4444"
</code></pre><p><strong>Options:</strong></p><ul><li><code>-c, --color <hex></code>: Group color in hex format (default: <code>#3b82f6</code>)</li></ul><h3>Update Groups</h3><pre><code>weeko group update <id> -n "New Name"
weeko group update <id> -c "#ec4899"
weeko group update <id> -n "Name" -c "#10b981"
</code></pre><p><strong>Options:</strong></p><ul><li><code>-n, --name <name></code>: New group name</li><li><code>-c, --color <hex></code>: New hex color</li></ul><h3>Delete Groups</h3><pre><code>weeko group delete <id> # Deletes group AND all its bookmarks
</code></pre><p><strong>Warning:</strong> Deleting a group permanently deletes all bookmarks within it.</p><h2>Batch Operations</h2><h3>Batch Move</h3><pre><code>weeko batch move --ids "id1,id2,id3" --group <targetGroupId>
</code></pre><p>Move multiple bookmarks to a different group.</p><h3>Batch Delete</h3><pre><code>weeko batch delete --ids "id1,id2,id3"
</code></pre><p>Delete multiple bookmarks at once.</p><h2>Output Formats</h2><h3>JSON (Default)</h3><p>Standard JSON output:</p><pre><code>{
"id": "clx...",
"title": "Example",
"url": "https://example.com"
}
</code></pre><h3>TOON (AI-Optimized)</h3><p>Token-optimized format for AI agents via <code>--format toon</code>:</p><pre><code>id\tclx...
title\tExample
url\thttps://example.com
</code></pre><h3>Pretty (Formatted Tables)</h3><p>Human-readable formatted tables via <code>--pretty</code>:</p><pre><code>┌────────────┬──────────────────────┬─────────────────────────────┐
│ ID │ Title │ URL │
├────────────┼──────────────────────┼─────────────────────────────┤
│ clx... │ Example │ https://example.com │
└────────────┴──────────────────────┴─────────────────────────────┘
(1 bookmarks)
</code></pre><h2>Global Options</h2><p>All commands support:</p><pre><code>--dry-run # Log actions without making API calls
--format toon # Output as TOON instead of JSON
-v, --version # Show version
</code></pre><h2>Best Practices</h2><ol><li><strong>Start with context</strong>: Run <code>weeko status</code> or <code>weeko tree</code> to understand the account structure</li><li><strong>Search before adding</strong>: Use <code>weeko search</code> to avoid duplicates</li><li><strong>Use dry-run</strong>: Test destructive operations with <code>--dry-run</code> first</li><li><strong>Use TOON format</strong>: Use <code>--format toon</code> for AI-optimized token-efficient output</li><li><strong>Batch when possible</strong>: Use <code>batch move</code> and <code>batch delete</code> for bulk operations</li></ol><h2>Error Handling</h2><p>The CLI provides helpful error messages with hints:</p><ul><li><strong>401 Unauthorized</strong>: Run <code>weeko login</code> to authenticate</li><li><strong>404 Not Found</strong>: Verify the ID is correct</li><li><strong>429 Rate Limited</strong>: Wait a few minutes before retrying</li><li><strong>500 Server Error</strong>: The Weeko server is experiencing issues</li></ul><p>All errors include:</p><ul><li>Error message</li><li>HTTP status code</li><li>Hint for resolution (when available)</li></ul><h2>Examples</h2><h3>Daily Workflow</h3><pre><code># Check account status
weeko status
# See group structure
weeko tree
# Add a new bookmark
weeko add "https://example.com/article" -g <groupId> -t "Great Article"
# Search for existing bookmarks
weeko search "javascript" --pretty
# Move bookmarks between groups
weeko batch move --ids "id1,id2" --group <newGroupId>
</code></pre><h3>Clean Up Workflow</h3><pre><code># Review all bookmarks
weeko list --pretty
# Search for specific items
weeko search "example.com"
# Delete unwanted bookmarks
weeko delete <id>
# Check group sizes before cleanup
weeko group list --pretty
</code></pre><h3>Content Curation</h3><pre><code># Create a new group
weeko group create "AI Resources" -c "#8b5cf6"
# Add bookmarks to the new group
weeko add "https://arxiv.org" -g <newGroupId> -t "arXiv"
weeko add "https://paperswithcode.com" -g <newGroupId> -t "Papers With Code"
# List group contents
weeko list -g <newGroupId> --pretty
</code></pre><h2>Resources</h2><p>See <code>references/commands.md</code> for detailed command reference, architecture info, and output format specifications.</p></div>
</div>
</div>
<div id="tab-versions" class="detail-content">
<div class="detail-section">
<h2>版本历史</h2>
<p style="margin-bottom:12px;font-size:14px;color:#94a3b8;">共 1 个版本</p>
<ul class="version-list">
<li>
<div>
<span class="version-tag">v1.4.0</span>
<span style="font-size:11px;color:#5b6abf;margin-left:8px;background:#eef0ff;padding:1px 8px;border-radius:10px;">当前</span> </div>
<div style="font-size:12px;color:#94a3b8;">
2026-05-03 08:16 安全 安全 </div>
</li>
</ul>
</div>
</div>
<div id="tab-security" class="detail-content">
<div class="detail-section">
<h2>安全检测</h2>
<div class="sec-grid"> <div class="sec-card">
<h4>腾讯云安全 (Keen)</h4>
<div class="sec-status sec-safe">
安全，无风险 </div>
<a href="https://tix.qq.com/search/skill?keyword=412db5433c19ce7fa3b4415543560d00" target="_blank">查看报告</a> </div>
<div class="sec-card">
<h4>腾讯云安全 (Sanbu)</h4>
<div class="sec-status sec-safe">
安全，无风险 </div>
<a href="https://static.cloudsec.tencent.com/html-report-v2/2026/05/26/430785_6524b2d28c3a9f4f7190a88fc7b1d8ec.html?q-sign-algorithm=sha1&q-ak=AKID8JMG1bzBC1dz96qNhssfFftujT1NCoFi&q-sign-time=1782892243%3B1814428243&q-key-time=1782892243%3B1814428243&q-header-list=host&q-url-param-list=&q-signature=3cc5933b0f9689db6dd6901f75434604f94e74c2" target="_blank">查看报告</a> </div>
</div>
</div>
</div>
<!-- Recommended Skills -->
<div style="margin-top:24px;">
<h2 style="font-size:18px;font-weight:600;margin-bottom:16px;">🔗 相关推荐</h2>
<div class="rec-grid">
<div class="rec-card">
<span class="badge-cat" style="margin-bottom:8px;display:inline-block;">dev-programming</span>
<h3><a href="/s/github">Github</a></h3>
<div class="rec-owner">steipete</div> <div class="rec-desc">使用 `gh` CLI 与 GitHub 交互，通过 `gh issue`、`gh pr`、`gh run` 和 `gh api` 管理议题、PR、CI 运行及高级查询。</div>
<div class="rec-stats">
<span style="color:#f39c12;">★ 686</span>
<span style="color:#5b6abf;">📥 330,823</span>
</div>
</div>
<div class="rec-card">
<span class="badge-cat" style="margin-bottom:8px;display:inline-block;">dev-programming</span>
<h3><a href="/s/mcporter">Mcporter</a></h3>
<div class="rec-owner">steipete</div> <div class="rec-desc">使用 mcporter CLI 直接列出、配置、认证及调用 MCP 服务器/工具（支持 HTTP 或 stdio），涵盖临时服务器、配置编辑及 CLI/类型生成功能。</div>
<div class="rec-stats">
<span style="color:#f39c12;">★ 198</span>
<span style="color:#5b6abf;">📥 68,175</span>
</div>
</div>
<div class="rec-card">
<span class="badge-cat" style="margin-bottom:8px;display:inline-block;">dev-programming</span>
<h3><a href="/s/codeconductor">CodeConductor.ai</a></h3>
<div class="rec-owner">larsonreever</div> <div class="rec-desc">AI驱动平台，提供快速全栈开发、智能体、工作流自动化及低代码AI集成的可扩展产品创建。</div>
<div class="rec-stats">
<span style="color:#f39c12;">★ 80</span>
<span style="color:#5b6abf;">📥 182,948</span>
</div>
</div>
</div>
</div>
</div>
<script>
document.addEventListener('DOMContentLoaded',function(){
document.querySelectorAll('.detail-tab').forEach(function(btn){
btn.addEventListener('click',function(e){
var tab = this.getAttribute('data-tab');
document.querySelectorAll('.detail-tab').forEach(function(b){b.classList.remove('active')});
document.querySelectorAll('.detail-content').forEach(function(c){c.classList.remove('active')});
this.classList.add('active');
var el = document.getElementById('tab-'+tab);
if(el) el.classList.add('active');
});
});
});
</script>
<div class="footer">
<p>Skill工具集 © 2026</p>
</div></body>
</html>