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 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.1",
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 = process.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 ?? 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
- "Tisty is not installed on this computer, or not where this launcher looks, so its tools are not available.",
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 ?? "2025-06-18",
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
  });