1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
|
{
lib,
stdenv,
rustPlatform,
fetchFromGitHub,
jq,
moreutils,
pnpm_10,
fetchPnpmDeps,
pnpmConfigHook,
nodejs,
cargo-tauri,
pkg-config,
wrapGAppsHook3,
makeBinaryWrapper,
git,
jujutsu,
libsoup_3,
openssl,
webkitgtk_4_1,
nix-update-script,
}:
rustPlatform.buildRustPackage (finalAttrs: {
pname = "annot";
version = "0.19.0";
__structuredAttrs = true;
strictDeps = true;
src = fetchFromGitHub {
owner = "denolehov";
repo = "annot";
tag = "v${finalAttrs.version}";
hash = "sha256-T9CG5S0H90xYNP5QcbuINNEIEGLVCqR7HRX4XYNrgM4=";
};
pnpmDeps = fetchPnpmDeps {
inherit (finalAttrs) pname version src;
pnpm = pnpm_10;
fetcherVersion = 3;
hash = "sha256-OHsq/So4YhonxSnT4fByZnlPnpYvjcf0UuHHgBGVIf8=";
};
postPatch = ''
jq '.bundle.createUpdaterArtifacts = false' src-tauri/tauri.conf.json | sponge src-tauri/tauri.conf.json
'';
cargoRoot = "src-tauri";
buildAndTestSubdir = finalAttrs.cargoRoot;
cargoHash = "sha256-F38w6rLm4VQ72p5DE/d92+vzy9ovX6P03r4Y+hGh7yc=";
nativeBuildInputs = [
jq
moreutils
pnpmConfigHook
pnpm_10
nodejs
cargo-tauri.hook
]
++ lib.optionals stdenv.hostPlatform.isLinux [
pkg-config
wrapGAppsHook3
]
++ lib.optionals stdenv.hostPlatform.isDarwin [
makeBinaryWrapper
];
nativeCheckInputs = [
git
jujutsu
];
buildInputs =
lib.optionals stdenv.hostPlatform.isLinux [
libsoup_3
openssl
webkitgtk_4_1
]
++ lib.optionals stdenv.hostPlatform.isDarwin [
openssl
];
# pnpmConfigHook runs with --ignore-scripts, so the postinstall that copies
# Excalidraw fonts from node_modules into static/ must be run manually.
preBuild = ''
node scripts/copy-excalidraw-fonts.js
'';
# Disable automatic wrapper to handle it manually per platform
dontWrapGApps = stdenv.hostPlatform.isLinux;
postFixup =
lib.optionalString stdenv.hostPlatform.isLinux ''
wrapGApp "$out/bin/annot"
''
+ lib.optionalString stdenv.hostPlatform.isDarwin ''
makeWrapper "$out/Applications/annot.app/Contents/MacOS/annot" "$out/bin/annot"
'';
passthru.updateScript = nix-update-script { };
meta = {
description = "Human-in-the-loop annotation tool for AI workflows";
longDescription = ''
annot is an annotation tool for human-in-the-loop AI workflows. AI
agents work fast, but vague feedback is a lossy channel. When an agent
drafts a plan, proposes a refactor, or generates code, annot provides a
moment of structured review: it opens a native window, you annotate
specific lines with located, typed comments, then it closes and returns
structured output to the agent.
annot can be used as a standalone CLI (open a file, annotate, get
output) or as an MCP server, allowing AI agents to block on human
review mid-workflow. It supports reviewing files, diffs, and
agent-generated content, with optional exit modes so the human can
signal approval, rejection, or custom next steps.
'';
homepage = "https://github.com/denolehov/annot";
license = lib.licenses.agpl3Only;
mainProgram = "annot";
maintainers = with lib.maintainers; [ fraggerfox ];
platforms = lib.platforms.linux ++ lib.platforms.darwin;
};
})
|
