io.github.noticedso/cli
Search your developer network and trace connection paths via GitHub & LinkedIn.
Ask AI about io.github.noticedso/cli
Powered by Claude Β· Grounded in docs
I know everything about io.github.noticedso/cli. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
@noticed/cli
CLI, MCP server, and Claude Code plugin for noticed β search your developer network, trace connections, and find the shortest path to anyone through GitHub and LinkedIn collaboration graphs.
npm install -g @noticed/cli
noticed search "AI engineers"
noticed path @sarahml
Add to your AI coding agent
The MCP server exposes two tools β search_network and get_connection_path β to any client that speaks Model Context Protocol. Pick your client below.
Claude Code
claude mcp add --scope project noticed -- npx -y @noticed/cli mcp
--scope project writes to .mcp.json at your repo root so the server is shared with everyone on the team. Drop the flag for a personal-scope install.
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"noticed": {
"command": "npx",
"args": ["-y", "@noticed/cli", "mcp"],
"env": {
"NOTICED_API_URL": "https://your-instance.noticed.so",
"NOTICED_API_KEY": "nk_live_β¦"
}
}
}
}
Cursor
Edit ~/.cursor/mcp.json (global) or .cursor/mcp.json (project):
{
"mcpServers": {
"noticed": {
"command": "npx",
"args": ["-y", "@noticed/cli", "mcp"],
"env": { "NOTICED_API_URL": "https://your-instance.noticed.so", "NOTICED_API_KEY": "nk_live_β¦" }
}
}
}
VS Code (Copilot Chat, GitHub Copilot agent mode)
Edit .vscode/mcp.json for workspace, or run MCP: Open User Configuration for global:
{
"servers": {
"noticed": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@noticed/cli", "mcp"],
"env": { "NOTICED_API_URL": "https://your-instance.noticed.so", "NOTICED_API_KEY": "nk_live_β¦" }
}
}
}
Note VS Code uses servers (not mcpServers) and requires type.
Windsurf
Edit ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"noticed": {
"command": "npx",
"args": ["-y", "@noticed/cli", "mcp"],
"env": { "NOTICED_API_URL": "https://your-instance.noticed.so", "NOTICED_API_KEY": "nk_live_β¦" }
}
}
}
Cline (VS Code)
Edit ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json:
{
"mcpServers": {
"noticed": {
"command": "npx",
"args": ["-y", "@noticed/cli", "mcp"],
"env": { "NOTICED_API_URL": "https://your-instance.noticed.so", "NOTICED_API_KEY": "nk_live_β¦" }
}
}
}
Continue
MCP works in agent mode only. Add .continue/mcpServers/noticed.yaml:
mcpServers:
- name: noticed
command: npx
args: ["-y", "@noticed/cli", "mcp"]
env:
NOTICED_API_URL: https://your-instance.noticed.so
NOTICED_API_KEY: nk_live_β¦
Zed
Edit ~/.config/zed/settings.json (note: key is context_servers, not mcpServers):
{
"context_servers": {
"noticed": {
"command": "npx",
"args": ["-y", "@noticed/cli", "mcp"],
"env": { "NOTICED_API_URL": "https://your-instance.noticed.so", "NOTICED_API_KEY": "nk_live_β¦" }
}
}
}
Claude Code skill
This package ships a Claude Code skill at skills/noticed-search/SKILL.md. Skills don't auto-discover from node_modules β symlink it into your skills directory once:
# Personal scope (all projects)
mkdir -p ~/.claude/skills
ln -s "$(npm root -g)/@noticed/cli/skills/noticed-search" ~/.claude/skills/noticed-search
# Project scope (this repo only)
mkdir -p .claude/skills
ln -s "$(npm root)/@noticed/cli/skills/noticed-search" .claude/skills/noticed-search
Or install the whole thing as a Claude Code plugin (skill + MCP bundled):
git clone https://github.com/noticedso/cli ~/.claude/plugins/noticed
# restart Claude Code
Quick start (CLI)
# 1. Mint an API key in your noticed dashboard at /dashboard/api-keys
# 2. Configure credentials
noticed config --set-url https://your-instance.noticed.so
noticed config --set-key nk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# 3. Search your network
noticed search "react developers"
# 4. Find the shortest path to a specific person
noticed path @sarahml
noticed path --li sarah-chen
# 5. JSON output for scripting
noticed search "frontend" --json | jq '.hits[].github_login'
Authentication
The CLI authenticates with a Bearer API key. Mint one at /dashboard/api-keys β the secret is shown once at create time, so copy it immediately. Tokens look like nk_live_β¦, are rate-limited to 60 requests per minute per key, and can be revoked from the same page.
CLI commands
noticed search <query>
Search your developer network for people, companies, skills, or topics.
noticed search "AI engineers" # natural language
noticed search "@sarahml" # GitHub username
noticed search "CTO at Vercel" # job title + company
noticed search "kubernetes" --source github # filter by source
noticed search "react" --limit 10 --json # paginated JSON output
noticed search "engineers" --csv > out.csv # CSV export
noticed search "Sarah Chen" --paths # also fetch paths to top hits
| Flag | Description | Default |
|---|---|---|
-l, --limit <n> | Maximum results | 25 |
-o, --offset <n> | Pagination offset | 0 |
-s, --source <src> | Filter: github or linkedin | all |
--sort <col:dir> | Sort: name:asc, company:desc | none |
-p, --paths | Fetch shortest paths to the top 5 hits | off |
-j, --json | Output raw JSON | off |
--csv | Output as CSV | off |
--no-color | Disable colors | auto |
noticed path [target]
Find the shortest connection path between you and a person.
noticed path @sarahml # by GitHub login
noticed path 12345 # by github_user_id
noticed path --li sarah-chen # by LinkedIn username
noticed path @sarahml --json # machine-readable
Logins are resolved via search before the path lookup. Pass --li to skip the search step and look up by LinkedIn username directly.
noticed config
noticed config # show current config
noticed config --set-url <url> # set API URL
noticed config --set-key <key> # set API key
noticed config --show # show current config
Config is stored at ~/.config/noticed/config.json (XDG-compliant).
noticed mcp
noticed mcp # start MCP server over stdio
noticed mcp --log-level debug # with debug logging on stderr
noticed completion <shell>
noticed completion bash >> ~/.bashrc
noticed completion zsh >> ~/.zshrc
noticed completion fish > ~/.config/fish/completions/noticed.fish
Environment variables
| Variable | Description | Required |
|---|---|---|
NOTICED_API_URL | Base URL of your noticed instance | yes |
NOTICED_API_KEY | API key for authentication | yes |
NOTICED_BASE_URL | Alias for NOTICED_API_URL | no |
Precedence: CLI flags > environment variables > config file.
MCP tools
| Tool | Description |
|---|---|
search_network | Search developers by name, company, skill, or topic. Optional source, sort, limit, offset, include_paths. |
get_connection_path | Find the shortest path to a target person. Accepts a natural-language query, an explicit github_user_id, or a linkedin_username. |
Test with the MCP Inspector:
npx @modelcontextprotocol/inspector npx @noticed/cli mcp
Or by hand:
echo '{"jsonrpc":"2.0","method":"initialize","id":1,"params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}' | noticed mcp
echo '{"jsonrpc":"2.0","method":"tools/list","id":2}' | noticed mcp
Programmatic usage
import { NoticedApiClient } from "@noticed/cli";
const client = new NoticedApiClient({
baseUrl: "https://your-instance.noticed.so",
apiKey: "nk_live_β¦",
});
const results = await client.search("AI engineers", { limit: 10 });
const path = await client.path({ to: results.hits[0]?.github_user_id });
console.log(results.hits, path);
Development
npm install
npm run build
npm test
npm run lint
npm run check-types
License
MIT Β© noticed
