cosense

Original：🇨🇳 Chinese

Translated

A skill for reading, researching, and editing pages on Cosense (formerly Scrapbox). Used when users make requests like "Look up XX on Cosense", "Read this Cosense page", "Do XX on Scrapbox", "View the page on scrapbox.io", "Add a comment to this page", etc. Retrieves pages using the cosense CLI and answers users' questions while citing the source of information.

3installs

Sourcehelpfeel/cosense-cli

Added on2026-08-23

NPX Install

npx skill4agent add helpfeel/cosense-cli cosense

SKILL.md Content (Chinese)

View Translation Comparison →

Cosense Skill Procedure

Use the

cosense

CLI to read and research Cosense pages and respond to users. Writing/deleting operations (such as page editing, adding comments, deleting pages or files, etc.) should only be performed when explicitly instructed by the user.

What is Cosense?

Cosense is a web-based Wiki that links multiple pages together to represent complex information as a knowledge graph. Inter-page links are expressed using the bracket notation

[Page Title]

.

Tips for Understanding Cosense

Don't rely solely on keyword searches; instead, browse and follow the list of related pages. Context that wasn't visible on a single page will emerge.
Pages with a high number of incoming links or page rank values in the knowledge graph also function as parents in hierarchical structures, similar to folders or categories.
Even if a page only has an abstract title with no explanation in its body, it may be explained in the context of other pages.

Actions for Scenarios

When you want to research or read a specific page

How to read a page: read-page.md

When only a project name is specified, pass
```
https://scrapbox.io/<project>
```
as the projectUrl to the CLI
When a project name + page title is specified, pass
```
https://scrapbox.io/<project>/<title>
```
as the pageUrl to the CLI
When a URL is included in the prompt, the entire URL from
```
https://
```
to the first whitespace character is treated as one. Cosense titles can be long Japanese sentences (spaces in titles are replaced with
```
_
```
in URLs), so Japanese characters, symbols,
```
_
```
, and particles that look like
```
/
```
should all be included as part of the URL until a whitespace is encountered. Cutting at the boundary between ASCII and Japanese will lead to accessing a different page than the user intended
URLs containing symbols should be enclosed in quotes (
```
'...'
```
) when passed in the shell

When the page you were reading disappears or you want to track changes made by collaborators

How to track changes: Refer to "Track Changes" in read-page.md

If the page you were reading suddenly becomes a 404 or an "empty uncreated page", it's possible that a collaborator changed the title
Use the pageId and commitId you noted when reading the page to check what changed (including renaming) with
```
browsePageChanges
```
before re-reading

When you want to edit a page or add a comment

Page editing procedure: edit-page.md

Only when the user explicitly instructs such as "Write", "Edit", "Add a comment", etc.
Do not refer to this for research, browsing, or summarization tasks

When you want to upload a file and embed it in a page

File upload procedure: upload-file.md

Only when the user explicitly instructs such as "Upload this image", "Paste the file", "Embed the image in the report", etc.
This procedure includes embedding the file, not just uploading it

When you want to log in or when an authentication error is returned

Login procedure: login.md

When the user explicitly instructs "Log in to Cosense"
When accessing a project that requires authentication with
```
browsePage
```
etc., and an HTTP 401 or 403 error is returned

When the CLI behavior differs from expectations

Version compatibility check: version-mismatch.md

```
unknown command
```
/
```
unknown option
```
errors
The structure of the returned JSON differs from the procedure manual
The command referenced in the procedure manual is not present in the
```
--help
```
output

List of CLI Commands

CLI Execution Command Format

Execute
```
cosense <command> <args...>
```
Install in advance with
```
npm install -g @helpfeel/cosense-cli
```
Requires Node 24+

Command List

command	Purpose
login	Save Personal Access Token or Service Account to the configuration file
whoami	Retrieve information about the currently authenticated user
listProjects	Retrieve a list of projects you are participating in
browsePage	Read a single page. Outputs metadata + icon notation + telomere + Infobox + body in a format easy for AI to read. Marks the relevant line if a line permalink ( `#<lineId>` ) is included
browseRelatedPages	Outputs a list of 1-hop+2-hop related page titles in a format easy for AI to read. For infobox definition pages, outputs a literary database (TSV table)
browsePageChanges	Retrieve the edit history (commits) of a page starting from the pageId, and explain who changed what and how in natural language. Detects title changes (renaming)
readPage	Read a single page
readPageSnapshot	Read the past body content from Page History by specifying the snapshot ID
readFileInfo	Retrieve file metadata and extracted text
downloadFile	Download the file itself and save it locally
uploadFile	Upload a file to the project and retrieve the embed URL
deleteFile	Delete a file from the project
readProjectMembers	Retrieve a list of project members
listPages	Retrieve a list of project pages
listPageSnapshots	Retrieve a list of page snapshots (Page History) starting from the pageId
list1hopLinks	Retrieve 1-hop neighbors
list2hopLinks	Retrieve 2-hop neighbors
searchVector	Search for pages using vector search (only targets titles + link notation in the body)
searchFullText	Perform a full-text search of the body content
search1hopLinks	Filter 1-hop neighbors with full-text search
search2hopLinks	Filter 2-hop neighbors with full-text search
previewEdit	Dry-run page edit ops to retrieve a previewId
previewDelete	Dry-run page deletion to retrieve a previewId
submitEdit	Use the previewId obtained from previewEdit/previewDelete to confirm page edits/deletions
replaceLinks	Batch replace link notation to old titles with new titles

To learn details about commands

List of all commands and overview:
```
cosense --help
```
Arguments, return value schema, and HTTP errors for individual commands:
```
cosense <command> --help
```
If you are unsure about the JSON structure of the return value, always read the help before using the command

Response Format

Directly answer the user's question while indicating the source (page URL)
No fixed template is specified