GitCortex: Agent for Claude Code

.claude/agents/gcx-typescript-tester.md

gcx-typescript-tester is an agent for Claude Code from bharath03-a/GitCortex. It costs 54 tokens per session (854 once invoked), scanned A, original, MIT.

A testing assistant for checking how well the GitCortex parser understands TypeScript code. TypeScript is a programming language that adds type information to JavaScript, and GitCortex indexes code symbols and their relationships.

In plain words
What is it for?
Cloning selected GitHub repositories, checking symbol and relationship coverage, and investigating TypeScript parsing failures.
Why use it?
It finds parser errors in real, large TypeScript projects instead of relying only on small test examples.

Agent for Claude Code

Written for Claude Code: installed under .claude/.

This is bharath03-a/GitCortex's own configuration. It tells Claude Code how to work on GitCortex itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything GitCortex configures →

Reuse

Borrowing it

Nothing to install: this file belongs to bharath03-a/GitCortex. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/bharath03-a/GitCortex/main/.claude/agents/gcx-typescript-tester.md
Clone the repo
git clone --depth 1 https://github.com/bharath03-a/GitCortex

Made for: Claude Code.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for gcx-typescript-tester

README.md
[![agentmods](https://agentmods.dev/badge/agents/bharath03-a/gitcortex/gcx-typescript-tester/github.svg)](https://agentmods.dev/agents/bharath03-a/gitcortex/gcx-typescript-tester)
Your own site
<a href="https://agentmods.dev/agents/bharath03-a/gitcortex/gcx-typescript-tester"><img src="https://agentmods.dev/badge/agents/bharath03-a/gitcortex/gcx-typescript-tester/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for gcx-typescript-tester

Your own site · 80×15
<a href="https://agentmods.dev/agents/bharath03-a/gitcortex/gcx-typescript-tester"><img src="https://agentmods.dev/badge/agents/bharath03-a/gitcortex/gcx-typescript-tester.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 54 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 854 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00054 $0.00854
Opus 5.5 $0.00022 $0.00342
Sonnet 5.5 $0.00011 $0.00171
Haiku 4.5 $0.00005 $0.00085

Measured 2mo ago against content hash a021186c8016, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

gcx-typescript-tester scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/agents/gcx-typescript-tester.md · 58 lines

How it starts

The opening of the file, as written. The whole thing — 58 lines — stays where its author put it; the contents beside it link to each section on GitHub.

You validate GitCortex (gcx) end-to-end against real TypeScript repositories.

Canonical test matrix

Repo Clone name Probe symbol Why
https://github.com/expressjs/express express Router classes, prototypes, exports
https://github.com/microsoft/TypeScript typescript-src Program large codebase, complex types
https://github.com/vercel/next.js nextjs NextConfig type exports, interfaces

Use the first repo unless the caller specifies otherwise. For a deep test, run all three.

Procedure

  1. Ensure release binary: cargo build --release -p gitcortex 2>&1 | tail -5 (skip if target/release/gcx is fresh).
  2. Run the harness for each repo: scripts/lang-smoke.sh <git-url> <probe-symbol> <clone-name>
  3. For each FAIL, dig in:
    • Re-run gcx query lookup-symbol <symbol> directly in the clone.
    • Check gcx query wiki <symbol> for malformed signatures (generics leaking into name).
    • Inspect if .d.ts declaration files are being indexed (they should be excluded).

TypeScript-specific red flags

Check these explicitly — most common failure modes:

  • interface vs class conflation: TypeScript interface Foo {} should map to Trait (or a dedicated kind), NOT Struct. class Foo {} → Struct. Verify with gcx query lookup-symbol.
  • Generic type params leaking into node names: HashMap<K, V> should produce node name HashMap, not HashMap<K, V>. Check name field in lookup output.
  • .d.ts files indexed: Declaration-only files should be excluded from indexing. If lookup-symbol returns nodes sourced from .d.ts files, the parser is over-indexing.
  • export type vs export const: Type-only exports (export type Foo = ...) → TypeAlias. Value exports → Constant or Function. Should not be conflated.
  • async functions: async function foo() and const foo = async () => {} both → is_async: true. Arrow function form is commonly missed.
  • Arrow function vs function declaration: Both should produce Function nodes. Arrow functions assigned to const are commonly skipped.
  • Implements edges for class Foo implements Bar: Must emit Implements edge from Foo → Bar.
  • Uses edges for type annotations: function f(x: Foo): Bar must emit Uses edges to both Foo and Bar.
  • Re-exports: export { Foo } from './foo' should produce Imports + makes Foo reachable.
  • Namespace/module merging: TypeScript allows namespace Foo {} and class Foo {} with same name — parser should not deduplicate them incorrectly.

Read the full file on GitHub · 58 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2mo ago First seen · 58 lines · 54 tokens per session scan A a021186c8016

Subscribe to this mod's changes

gcx-typescript-tester is an agent published in the GitHub repository bharath03-a/GitCortex (8 stars, last pushed 2d ago), licensed MIT. It adds 54 tokens to every session and 854 once invoked, about $0.0002 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other agents, from other repositories

cli-developer

CLI and terminal tool development specialist for Commander.js applications, plugin architectures, terminal UX with chalk, and integration testing with node:test.

pjt222/agent-almanac · 29 tokens

playwright-automation-engineer-ts-detailed

Provide expert guidance, code, and troubleshooting help for end-to-end and component-level test automation using Playwright with TypeScript. Full methodology with patterns and examples; use playwright-expert for the concise day-to-day variant.

jaktestowac/awesome-copilot-for-testers · 54 tokens

hcc-frontend-iqe-to-playwright-converter

Use this agent to convert IQE/Selenium tests to Playwright TypeScript. This agent implements proper Red Hat SSO authentication (global or isolated), converts fixtures and page objects, modernizes selectors and wait patterns, uses symbolic timeout constants, handles parametrized tests, and organizes converted files by…

RedHatInsights/platform-frontend-ai-toolkit · 215 tokens

testing-engineer

Testing specialist for Rust, TypeScript, and Luau/Lua projects focused on comprehensive test coverage, test infrastructure, and quality assurance. Applies the project's language rules from the stack profile. Use PROACTIVELY when adding new functionality that requires tests, investigating test failures, or setting up…

bug-ops/claude-plugins · 137 tokens

typescript-pro

Master TypeScript with advanced types, generics, and strict type safety. Handles complex type systems, decorators, and enterprise-grade patterns. Use PROACTIVELY for TypeScript architecture, type inference optimization, or advanced typing patterns.

NOMARJ/sigil · 49 tokens

test-generator

Use this agent to generate high-quality TypeScript unit tests for a target file or directory. Detects the host project's test runner (Jest, Vitest, node:test) and follows the project's documented testing standards.

trickycdm/tricky-cc-plugins · 46 tokens