Skip to content

Instantly share code, notes, and snippets.

View bgauryy's full-sized avatar

bgauryy

  • Tel Aviv
View GitHub Profile
@bgauryy
bgauryy / AI_ASSISTANT_TOOLS.txt
Created August 11, 2026 09:32
META_AI_ASSISTANT_TOOLS
Meta AI Tool Reference
1. http://browser.search
- Scheme: primary_query, verbosity_level, verticals
- Description: Search the web for current info, facts, news, scores, prices
- How it works: I send a query to the web. Returns snippets with sources I can cite.
- How to use: "search latest iPhone price" or "what happened today in sports"
- Edge/Instruction: Use when answer needs to be up-to-date. I auto-cite sources.
2. meta_1p.content_search
@bgauryy
bgauryy / research.md
Last active July 15, 2026 11:42
Why humans are needed when refining agents

Idea Brief: Why humans are needed when refining agents — and why agents teaching agents can break

Field Value
Status Contested
Mode Validate / Map
Created 2026-07-13
Verdict Contested
Decision Narrow
@bgauryy
bgauryy / Headroom.md
Created June 8, 2026 14:16
Explains how Headroom works under the hood

Headroom Token Savings

A concise explanation of how Headroom reduces LLM token usage.

Summary

Headroom sits between an app/agent and the LLM provider. It rewrites large inputs into smaller, task-preserving forms before the request is sent. The original content is kept locally and can be retrieved later by hash.

It saves tokens through three main ideas:

Claude Prompt Engineering Cheatsheet

Best practices for writing instructions that Claude reliably follows.


1. Command Strength Hierarchy

Use stronger language for critical instructions:

@bgauryy
bgauryy / clawdbot-security-audit.md
Last active January 25, 2026 12:08
Clawdbot Security Audit Report - A code-verified security assessment of the clawdbot WhatsApp AI assistant (v2026.1.24-0) identifying 18 security issues across critical, high, and medium severity levels. Key findings: (1) WhatsApp messages including phone numbers, GPS locations, and group contacts flow unsanitized to external AI providers (Anthr…

Clawdbot Code Analysis Report


@bgauryy
bgauryy / LOCAL_TOOLS_TEST_PLAN.md
Created January 1, 2026 20:41
Comprehensive test framework (380+ test cases) comparing Octocode MCP local tools against Claude Code and Cursor built-in tools across 9 test suites. Covers four tool categories: code search, directory listing, file reading, and file finding. Tests span 10 dimensions: context quality, efficiency, output quality, token safety, security, error han…

Local Tools Test Plan: AI Coding Assistants vs Octocode MCP

Comprehensive test plan comparing AI coding assistant internal tools with Octocode MCP local tools

Objective: Validate that Octocode local tools provide superior context, efficiency, output quality, token safety, and security compared to built-in tools in Claude Code and Cursor.


Tool Mapping Overview

@bgauryy
bgauryy / OCTOCODE_CURSOR_LOCAL_COMPARISON.md
Last active January 1, 2026 20:42
Head-to-head comparison of Octocode MCP local tools vs Cursor's built-in tools on the Linux kernel (100K+ files). Tests four tool categories—code search, directory listing, file reading, and file finding—using identical queries. Evaluates output structure, metadata richness, pagination, token efficiency, and actionable guidance. Result: Octocode…

🔬 ADVANCED DEPTH COMPARISON: Octocode MCP vs Cursor Internal Tools

Repository: Linux Kernel (100K+ Files)


🎯 Motivation

Cursor provides built-in local tools (grep, list_dir, read_file, glob_file_search) that AI agents use to explore and understand codebases. These tools are fast, simple, and familiar—but are they sufficient for large-scale code research?

@bgauryy
bgauryy / octocode_security.md
Created November 20, 2025 17:58
Octocode output doc for a security review doing on dzhng/claude-agent-server repo using review prompt
@bgauryy
bgauryy / data-format-token-test.js
Created November 15, 2025 08:46
Measures token count using the cl100k_base tokenizer (used by GPT-4/Claude) for CSV, TOON, JSON
import { encode as toonEncoder } from '@byjohann/toon'
import { createByEncoderName } from '@microsoft/tiktokenizer'
import { stringify } from 'csv-stringify/sync'
import { writeFileSync, mkdirSync } from 'fs'
import { join } from 'path'
// Helper function to convert data to CSV format
function dataToCSV(data) {
// Handle arrays of objects (most common CSV case)
if (Array.isArray(data)) {
@bgauryy
bgauryy / AGENTIC_AI_LEARNING_PATH.md
Created November 9, 2025 08:27
Octocode AI Research Summary On - github. com/panaversity/learn-agentic-ai