Turbocharge Claude Code, Cursor, Codex, Gemini & every coding agent: faster, cheaper, with contextual understanding specific to your codebase.
TypeScript ai-agentsanthropicclaude-codeclicode-graphcodexcontext-engineeringcursordeveloper-toolsgeminiknowledge-graphllmmcpmcp-serveropen-sourceopenaitree-sitter
// Prints a one-line nudge after install, and records the anonymous `install`
// event. Never fails the install.
import { existsSync, readFileSync } from 'node:fs';
import { spawn } from 'node:child_process';
import { dirname, join } from 'node:path';
import { fileURLToPath, pathToFileURL } from 'node:url';
const root = dirname(dirname(fileURLToPath(import.meta.url)));
// The same code ships as @trailhq/trail-code (the `trail` command) and as
// @nanonets/graft (`graft`, its old name). The install event and the nudge say
// which one this is.
let pkgName = '@nanonets/graft';
try {
pkgName = JSON.parse(readFileSync(join(root, 'package.json'), 'utf8')).name ?? pkgName;
} catch { /* the graft defaults */ }
const isTrail = pkgName === '@trailhq/trail-code';
if (isTrail) process.env.TRAIL_INVOKED_AS = 'trail';
/**
* Record the install, then hand the queue straight to a detached child.
*
* Sending here rather than letting the daily flush pick it up is the entire
* point of the event: the machine we most want to count is the one that installs
* graft and never runs a command, and that machine never reaches a flush. The
* child is detached with stdio ignored, so npm waits on no socket and an offline
* install looks like any other.
*
* Every gate still applies — a fork or a local build has no key, and CI,
* `DO_NOT_TRACK` and `graft telemetry disable` all close it. See TELEMETRY.md.
*/
async function recordInstall() {
// `dist/` is absent when this runs from a clone, where `prepare` builds AFTER
// postinstall. Nothing to record there, and a fork has no key regardless.
const entry = join(root, 'dist', 'telemetry', 'index.js');
const cli = join(root, 'dist', 'cli.js');
if (!existsSync(entry) || !existsSync(cli)) return;
const mod = await import(pathToFileURL(entry).href);
// A `dist/` from an older version has no such export. Absent, not broken.
if (typeof mod.trackInstallIfNew !== 'function') return;
// npm sets this for `npm i -g`; only its value 'true' means global.
mod.trackInstallIfNew({ global: process.env.npm_config_global === 'true' });
const child = spawn(process.execPath, [cli, '_telemetry-flush'], {
detached: true,
stdio: 'ignore',
});
child.unref();
}
try {
if (process.env.CI) process.exit(0);
const dir = process.env.INIT_CWD || process.cwd();
// Its own catch: the nudge is the part a user sees, and a telemetry fault must
// not be able to silence it.
try { await recordInstall(); } catch { /* telemetry is never worth an error */ }
if (existsSync(join(dir, '.claude', 'helpers', 'graft-statusline.cjs'))) process.exit(0);
if (existsSync(join(dir, '.claude', 'helpers', 'trail-statusline.cjs'))) process.exit(0);
console.log(
isTrail
? '\n Trail installed. Run `trail init` in a repo to wire it into your agents.\n'
: '\n Graft installed. Run `npx graft init` to enable the Claude Code integration (statusline + hooks + auto-sync).\n',
);
} catch {
/* never fail an install */
}