Memos Crud

Instructions

Use this skill when you need to interact with a Memos server to manage notes/memos. This skill provides a Ruby CLI wrapper around the Memos REST API. Always prefer using this CLI over raw curl requests to ensure consistent error handling and state management.

prerequisites

• Ensure the memos_skill directory is your working directory or you reference the script path correctly.
• The environment variables in .env must be configured (checked automatically by the script).

Commands

Run the CLI using ruby scripts/memos_cli.rb <command> [options]. All commands return JSON.

1. List Memos

Fetch a list of memos. default limit is 50.

ruby scripts/memos_cli.rb list --page-size 10 --state NORMAL

Options:

• --page-size N: Number of items (default 50).
• --page-token TOKEN: For pagination.
• --state STATE: NORMAL or ARCHIVED.
• --filter "content.contains('keyword')": Filter by content.

2. Create Memo

Create a new memo.

ruby scripts/memos_cli.rb create --content "My new memo content" --visibility PRIVATE

Options:

• --content "STRING": (Required) The content of the memo.
• --visibility VIS: PRIVATE (default), PROTECTED, or PUBLIC.
• --pinned BOOL: true or false.

3. Get Memo

Get a single memo by details.

ruby scripts/memos_cli.rb get --memo memos/123

Options:

• --memo ID: The memo ID (e.g., 123 or memos/123).

4. Update Memo

Update an existing memo. Only detailed fields are updated.

ruby scripts/memos_cli.rb update --memo memos/123 --content "Updated content" --pinned true

Options:

• --memo ID: (Required) Target memo.
• --content "STRING"
• --visibility VIS
• --pinned BOOL
• --state STATE: Archive/Unarchive using ARCHIVED or NORMAL.

5. Delete Memo

Delete a memo permanently (or soft delete if the system supports it, but this CLI assumes standard delete).

ruby scripts/memos_cli.rb delete --memo memos/123

Options:

• --memo ID: (Required) Target memo.
• --force true: params to force delete if applicable.

Output Format

Success:

{
  "ok": true,
  "data": { ...memo object... }
}

Error:

{
  "ok": false,
  "error": "Error message",
  "http_status": 400,
  "payload": { ... }
}