git404hub

what is somethingsoff fr?

aarmanroy/somethingsoff — explained in plain English

Analysis updated 2026-05-18

2RustAudience · developerComplexity · 2/5LicenseSetup · easy

tl;dr

A local-first Rust CLI that instantly indexes and searches your app's log files, built for both human developers and AI coding agents debugging failures.

vibe map

mindmap
  root((somethingsoff))
    What it does
      Local log search
      Zero setup indexing
      Error grouping
    Tech stack
      Rust
      Tantivy
      Claude Code plugin
    Use cases
      Debugging errors
      Request tracing
      AI agent debugging
    Audience
      Developers
      AI coding agents

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Search all error logs from the last hour without manually scrolling through files.

VIBE 2

Trace every log line related to a single request using its request ID.

VIBE 3

Let Claude Code automatically surface the real error the moment a command fails during a session.

VIBE 4

Pipe any running program's output directly into the tool for instant searchability, no log files required.

what's the stack?

RustTantivyClaude Code

how it stacks up fr

aarmanroy/somethingsoff132ikl/game1lystore/pay-dcp
Stars222
LanguageRustRustRust
Last pushed2020-12-30
MaintenanceDormant
Setup difficultyeasymoderatemoderate
Complexity2/52/53/5
Audiencedevelopergeneraldeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Works with existing log files or piped process output, no daemon or account required.

in plain english

somethingsoff is a command line tool written in Rust that makes your application's log files instantly searchable, without needing any setup, background service, or account. Everything runs locally on your own machine, and nothing you search ever leaves it. The idea is that when something goes wrong in an app, instead of manually scrolling through log files, you can just ask a direct question, such as showing every error from the last hour or tracing everything tied to one specific request. The tool is built with AI coding agents in mind as much as human developers. It ships as a plugin for Claude Code that teaches the assistant when to check your logs on its own, and includes a feature that automatically shows the assistant the real underlying error the moment a command fails during a coding session, rather than the assistant guessing at what went wrong. This turns a repetitive debugging habit, asking the same small questions over and over while fixing a bug, into something both a person and an AI agent can do quickly. Getting started just means having a folder of log files, or piping any running program's output directly into the tool, and it works regardless of what language wrote the logs. It automatically recognizes many common log formats, including JSON, plain text formats used by Python and Go, and web server logs, and understands mixed formats within a single file. Anything it cannot recognize is still saved as plain text rather than being dropped. Every time you run a search, it quietly checks for new log lines since the last check and adds only those to its index, so results are always current without needing a separate update step. The tool groups near-identical errors together instead of showing hundreds of near-duplicate lines, and automatically redacts things like emails, tokens, and card numbers before they are stored, though this can be turned off. Every command answers in one consistent structured format with clear error codes and hints on what to try next, which is particularly useful for an AI agent trying to recover from a failed command on its own. It can be installed as a prebuilt binary or through Rust's cargo package manager, and is released under the MIT license.

prompts (copy fr)

prompt 1
Show me how to set up somethingsoff to search my app's ./logs directory for errors in the last 24 hours.
prompt 2
Explain how to install the somethingsoff Claude Code plugin so it checks logs automatically on command failure.
prompt 3
Walk me through piping my dev server's output into somethingsoff using the tap command.
prompt 4
How do I configure somethingsoff to add an extra log source outside the default ./logs folder?

Frequently asked questions

what is somethingsoff fr?

A local-first Rust CLI that instantly indexes and searches your app's log files, built for both human developers and AI coding agents debugging failures.

What language is somethingsoff written in?

Mainly Rust. The stack also includes Rust, Tantivy, Claude Code.

How hard is somethingsoff to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is somethingsoff for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.