tisty-mcp 1.0.1 → 1.0.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +7 -0
- package/package.json +2 -1
- package/server/install.txt +4 -0
- package/server/launch.mjs +20 -11
package/README.md
CHANGED
|
@@ -9,6 +9,13 @@ dates, writes and edits documents passage by passage, files them into folders
|
|
|
9
9
|
and searches open and archived work. It never closes or deletes anything: it
|
|
10
10
|
says a task is done and you confirm it in the app.
|
|
11
11
|
|
|
12
|
+
**Your agents' work, in the open.** Through Tisty, an agent plans in
|
|
13
|
+
documents and works in tasks: it writes the plan, what it found and what it
|
|
14
|
+
decided as Markdown, breaks the work into tasks with steps and ticks them off as
|
|
15
|
+
it goes. Nothing stays buried in a chat: every stage lands in Tisty, on your
|
|
16
|
+
computer, where you can follow it as it happens and audit it later. When it says
|
|
17
|
+
a task is done, you are the one who closes it.
|
|
18
|
+
|
|
12
19
|
## Install
|
|
13
20
|
|
|
14
21
|
In Claude Code:
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "tisty-mcp",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.3",
|
|
4
4
|
"description": "Starts the MCP server of the Tisty app installed on this computer: notes, documents and tasks as plain Markdown on your own disk.",
|
|
5
5
|
"mcpName": "io.github.rgdevment/tisty",
|
|
6
6
|
"type": "module",
|
|
@@ -8,6 +8,7 @@
|
|
|
8
8
|
"tisty-mcp": "server/tisty.mjs"
|
|
9
9
|
},
|
|
10
10
|
"files": [
|
|
11
|
+
"server/install.txt",
|
|
11
12
|
"server/launch.mjs",
|
|
12
13
|
"server/tisty.mjs"
|
|
13
14
|
],
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
Tisty is not installed on this computer, or not where this launcher looks, so its tools are not available.
|
|
2
|
+
Install it from https://www.tisty.app/docs/installation/: on Windows from the Microsoft Store or the installer, on macOS with `brew install --cask rgdevment/tap/tisty`.
|
|
3
|
+
Open it once, turn assistants on in Settings › Assistants, then restart this assistant.
|
|
4
|
+
If Tisty is installed somewhere else, set TISTY_PATH to the full path of its `tisty` command.
|
package/server/launch.mjs
CHANGED
|
@@ -4,12 +4,23 @@ import { homedir } from "node:os";
|
|
|
4
4
|
import path from "node:path";
|
|
5
5
|
import { createInterface } from "node:readline";
|
|
6
6
|
|
|
7
|
-
export const INSTALL = "https://www.tisty.app/docs/installation/";
|
|
8
7
|
const { version: VERSION } = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf8"));
|
|
8
|
+
// Kept as text beside the code, so nothing that runs carries an address it could reach out to.
|
|
9
|
+
const HOW_TO_INSTALL = readFileSync(new URL("./install.txt", import.meta.url), "utf8").trim();
|
|
10
|
+
// The ones Tisty's own server answers `initialize` with, so the stand-in promises nothing the app would not.
|
|
11
|
+
const PROTOCOL_VERSIONS = ["2025-11-25", "2025-06-18"];
|
|
12
|
+
|
|
13
|
+
// Only what the search needs, never the whole environment.
|
|
14
|
+
const ASKED = {
|
|
15
|
+
TISTY_PATH: process.env.TISTY_PATH,
|
|
16
|
+
PATH: process.env.PATH,
|
|
17
|
+
LOCALAPPDATA: process.env.LOCALAPPDATA,
|
|
18
|
+
WSL_DISTRO_NAME: process.env.WSL_DISTRO_NAME,
|
|
19
|
+
};
|
|
9
20
|
|
|
10
21
|
/** Where a Tisty install leaves its `tisty` command, most likely first; TISTY_PATH alone when it is set. */
|
|
11
22
|
export function places({
|
|
12
|
-
env =
|
|
23
|
+
env = ASKED,
|
|
13
24
|
platform = process.platform,
|
|
14
25
|
home = homedir(),
|
|
15
26
|
windowsLocal,
|
|
@@ -19,7 +30,7 @@ export function places({
|
|
|
19
30
|
const paths = platform === "win32" ? path.win32 : path.posix;
|
|
20
31
|
// A PATH holds dozens of folders; asking only where a file is spares a process per folder at every start.
|
|
21
32
|
const onPath = (name) =>
|
|
22
|
-
(env.PATH ??
|
|
33
|
+
(env.PATH ?? "")
|
|
23
34
|
.split(paths.delimiter)
|
|
24
35
|
.filter(Boolean)
|
|
25
36
|
.map((dir) => paths.join(dir, name))
|
|
@@ -102,13 +113,8 @@ export function run(file, args) {
|
|
|
102
113
|
}
|
|
103
114
|
|
|
104
115
|
export function missing(looked) {
|
|
105
|
-
return
|
|
106
|
-
|
|
107
|
-
`Install it from ${INSTALL}: on Windows from the Microsoft Store or the installer, on macOS with \`brew install --cask rgdevment/tap/tisty\`.`,
|
|
108
|
-
"Open it once, turn assistants on in Settings › Assistants, then restart this assistant.",
|
|
109
|
-
"If Tisty is installed somewhere else, set TISTY_PATH to the full path of its `tisty` command.",
|
|
110
|
-
`Looked in: ${looked.length ? looked.join(", ") : "nowhere (no place known for this system)"}.`,
|
|
111
|
-
].join("\n");
|
|
116
|
+
return `${HOW_TO_INSTALL}
|
|
117
|
+
Looked in: ${looked.length ? looked.join(", ") : "nowhere (no place known for this system)"}.`;
|
|
112
118
|
}
|
|
113
119
|
|
|
114
120
|
/** Without Tisty, a server of one tool that tells the person how to get it. */
|
|
@@ -129,7 +135,9 @@ export function standIn(looked, input = process.stdin, output = process.stdout)
|
|
|
129
135
|
switch (request.method) {
|
|
130
136
|
case "initialize":
|
|
131
137
|
return answer(request.id, {
|
|
132
|
-
protocolVersion: request.params?.protocolVersion
|
|
138
|
+
protocolVersion: PROTOCOL_VERSIONS.includes(request.params?.protocolVersion)
|
|
139
|
+
? request.params.protocolVersion
|
|
140
|
+
: PROTOCOL_VERSIONS[0],
|
|
133
141
|
capabilities: { tools: {} },
|
|
134
142
|
serverInfo: { name: "tisty", version: VERSION },
|
|
135
143
|
instructions: message,
|
|
@@ -145,6 +153,7 @@ export function standIn(looked, input = process.stdin, output = process.stdout)
|
|
|
145
153
|
description:
|
|
146
154
|
"Tisty is not installed on this computer, so its tools are missing. Call this for the steps to install it and tell the person.",
|
|
147
155
|
inputSchema: { type: "object", properties: {}, additionalProperties: false },
|
|
156
|
+
annotations: { readOnlyHint: true, destructiveHint: false, idempotentHint: true, openWorldHint: false },
|
|
148
157
|
},
|
|
149
158
|
],
|
|
150
159
|
});
|