Skip to content

Instantly share code, notes, and snippets.

View oneryalcin's full-sized avatar

Mehmet Öner Yalçın oneryalcin

View GitHub Profile
@oneryalcin
oneryalcin / README.md
Created September 23, 2026 13:08
Export all your X (Twitter) bookmarks to JSON + CSV from the browser console — full text, expanded links, media, quotes, stats

Export all your X (Twitter) bookmarks — full text, links, media, quotes

A single paste-into-console script. No extension, no API key, no install. It listens to the GraphQL responses X's own web app already fetches while you scroll your bookmarks, and downloads everything as JSON (full detail) and CSV (one row per bookmark).

Tested Sep 2026: exported 1,665 bookmarks (2023 → 2026) in one run.

How to use

@oneryalcin
oneryalcin / srt_tools.py
Last active September 4, 2026 14:06
yt_subs.py - YouTube subtitle generator (SRT/TXT/JSON) via Microsoft MAI-Transcribe 2 on OpenRouter. Single-file uv script, PEP 723 inline deps, 60 languages, auto language ID, word-level timings, optional diarization.
#!/usr/bin/env -S uv run --script
# /// script
# requires-python = ">=3.11"
# dependencies = []
# ///
"""Split, validate and merge SRT files for the subtitling pipeline.
srt_tools.py split tr_raw.srt blocks/ --cues 120
srt_tools.py check blocks/en_001.srt
srt_tools.py merge blocks/ en_final.srt --prefix en_
@oneryalcin
oneryalcin / needle-projects-ledger.md
Last active August 22, 2026 18:56
Needle (Cactus Compute) project ledger — community ports, HF assets, use-cases, fine-tuning, online chatter, curated picks

Needle Project Ledger

Tracking Cactus Compute's Needle ecosystem — official tooling, community ports, integrations, use-cases, and fine-tuning resources.

The model in one line: Needle 2 = 45M-param tool-calling / structured-extraction LLM shipped as a single ~14MB .cact binary, running a session in ~28MB RAM, ~2-bit CQ quantization (Simple Attention Network / Hadamard MLP + GQA).


@oneryalcin
oneryalcin / oma-handoff.md
Created June 26, 2026 10:21
OMA (open-managed-agents) handover — current state @ 5c41845, review discipline, gotchas, and queue (2026-06-11)

Handoff

This repository rewards conservative systems engineering.

Think:

  • John Carmack on invariants, restart behavior, and concrete failure modes
  • Martin Fowler on explicit boundaries and refactoring toward clarity
  • Robert C. Martin on readable intent and small surfaces
  • Gang of Four only when an abstraction clearly earns its keep
@oneryalcin
oneryalcin / agentic-browsers.md
Created May 29, 2026 20:07
Agentic Browsers & Headless Browser Infrastructure — Options Matrix (CDP / self-host / stealth). Maintained reference.

Agentic Browsers & Headless Browser Infrastructure — Options Matrix

Living reference for cloud browser infra, self-hosted/stealth engines, and the libraries/frameworks that drive them. Curated for agentic web automation at scale (e.g. crawling heterogeneous IR/filing sites), where the deciding filter is usually CDP/Playwright control + stealth/proxy for WAF'd sites.

Last verified: 2026-05-29 · Maintainer: @oneryalcin


How to read this

@oneryalcin
oneryalcin / claaude_cli_messages.md
Created May 19, 2026 17:21
Claude code Message Types and Event Types

⏺ Here's what v2.1.144 has today (covering CLI 2.1.97+, 134 $defs total):

  17 top-level message types

  The 17 things that can appear as a JSONL line in ~/.claude/projects/<proj>/*.jsonl:

  Core conversation — UserMessage, AssistantMessage, SystemMessage, SummaryMessage, ProgressMessage, AttachmentMessage
@oneryalcin
oneryalcin / teams-gemini-bot.md
Created May 13, 2026 07:19
Architecture and references for building a real-time Microsoft Teams voice bot using Gemini Flash Multimodal Live API

Building a Real-time Microsoft Teams Voice Bot with Gemini Flash

This document outlines the architectural path and references for building a real-time, voice-to-voice bot for Microsoft Teams using Google's Gemini Multimodal Live API (Gemini 1.5/2.0 Flash).

Currently, there is no single "turn-key" open-source repository for this exact integration. Instead, developers combine three core technologies:

1. The AI Engine: Gemini Multimodal Live API

The Gemini Multimodal Live API allows for streaming raw audio and video over WebSockets, providing sub-second audio responses.

  • Reference: Google Gen AI Python SDK
  • Key Feature: Native support for real-time voice input/output, and contextual understanding.
@oneryalcin
oneryalcin / codex-app-server-guide.md
Created April 29, 2026 10:23
Building on codex app-server: a developer's guide to OpenAI Codex's JSON-RPC interface (transports, methods, hooks, subagents, skills, MCP, Python SDKs, reference architecture, recipes)

Building on codex app-server: a developer's guide to OpenAI Codex's JSON-RPC interface

Practical, no-fluff reference for building applications, IDE plugins, agents, batch tools, or alternative client harnesses on top of OpenAI Codex's app-server interface.

This guide distills:

  • What codex app-server actually is on the wire (transports, handshake, framing).
  • The full method surface (threads, turns, review, MCP) and event/notification stream.
  • How filesystem-resident features (hooks, subagents, skills, MCP, plugins, AGENTS.md) interact with the protocol.
  • Where state lives on disk (Codex core state vs. companion state).
  • The official Python SDK surface — what it covers, what it omits, when to drop to request(...).
@oneryalcin
oneryalcin / tool_adding_guidelines.md
Created April 28, 2026 08:58
Golden Rule of Tools in Code Mode

A tool earns its surface by replacing complexity the model can't reliably write, not by replacing complexity the model can.

xlsx info and xlsx get clear that bar:

  • They wrap a Rust calamine parser, streaming, format detection, hidden-sheet handling, formula vs value resolution, range parsing, sparse-cell encoding. Re-implementing that in pandas is a 200–500 line job per task, slow, memory-heavy, and easy to get wrong. The tool is the only sane path.
  • xlsx analyze clears it too, but for a different reason: it's an LLM call with a curated prompt,
@oneryalcin
oneryalcin / tla_verification.yaml
Created April 22, 2026 21:47
TLA Plus verifications
---
name: tla-verification
description: TLA+/PlusCal formal verification for concurrent protocol design. Use when modeling async systems, checking race conditions, or verifying state machine correctness before implementation.
---
# TLA+ Protocol Verification — Pilot's Checklist
You are a formal verification specialist. You help design, write, debug, and run PlusCal/TLA+ specifications for concurrent systems, with a focus on asyncio-style cooperative concurrency patterns. You know the sharp edges of PlusCal, TLC model checking, and how formal models map to real implementation code.
## When to Use This Skill