Herramientas

QuietContext

Mantiene las salidas extensas fuera del contexto del agente, con comandos qc y siete herramientas MCP de búsqueda y navegación del repositorio.

Configurar con un agenteVer proyecto

Qué problema resuelve

Un registro de pruebas largo o archivos volcados una y otra vez ocupan el espacio de las instrucciones útiles. QuietContext conserva el material extenso fuera de la conversación y devuelve resultados compactos o referencias consultables. Cada raíz de proyecto tiene su propio almacén de búsqueda.

Formas de usarlo

  • Leer un fallo sin llenar el chat

    Ejecuta las pruebas reales del proyecto mediante qc run. Se conserva el código de salida y se compacta la salida extensa; el texto omitido puede recuperarse mediante evidencias retenidas o búsqueda.

  • Encontrar un símbolo antes de leer archivos

    Usa qc repo map para orientarte y después qc repo symbol MyType o qc repo references MyType. Sustituye MyType por el símbolo del proyecto para localizar primero el código pertinente.

  • Reutilizar un documento sin volver a pegarlo

    Indexa un README o una carpeta pequeña de documentación y busca un término de configuración. Mantén la misma identidad de proyecto para consultar el mismo almacén después.

Antes de empezar

  • Node.js 22.5 o posterior y npm; el archivo nativo documentado admite Linux x64 y Windows x64.
  • El archivo de la versión y su SHA256SUMS publicado. Un clon Git no incluye el ejecutable qc nativo preparado.
  • Un cliente compatible con MCP solo si quieres integrarlo con un agente; la CLI qc puede usarse por separado.

Instalación y configuración

  1. Descargar y verificar la versión candidata

    Desde la versión enlazada en el README, descarga quietcontext-1.1.0-rc.3.tgz y SHA256SUMS en una carpeta. En Linux usa la comprobación siguiente; en Windows compara Get-FileHash con el valor publicado.

    sha256sum -c SHA256SUMS

  2. Instalar el archivo verificado

    Ejecuta desde la carpeta de descarga. Instala la CLI empaquetada, no el paquete context-mode del proyecto original. Revisa primero las limitaciones de la versión candidata y la plataforma.

    npm install -g ./quietcontext-1.1.0-rc.3.tgz
qc --version
qc status

  3. Conectar el agente de forma opcional

    Para MCP stdio, configura el cliente para ejecutar quietcontext, no qc. Usa una ruta absoluta si no lo encuentra. Conserva los servidores existentes y comprueba las siete herramientas en una sesión nueva.

    [mcp_servers.quietcontext]
command = "quietcontext"

Uso en tu proyecto

  1. Inspeccionar un repositorio

    Ejecuta desde la raíz del proyecto. El mapa ofrece una vista general; usa después una consulta de símbolos o referencias para precisar la ubicación.

    qc repo map
qc run -- git status --short

  2. Indexar un documento no sensible

    Empieza con el README del proyecto. La etiqueta permite encontrarlo después; elige un archivo que tengas permiso para procesar.

    qc index README.md --source project-readme

  3. Buscar una frase que sabes que existe

    Sustituye installation por una palabra del README. Cero coincidencias es un resultado válido. Usa la misma carpeta o --project al indexar y buscar.

    qc search installation --source project-readme --full

Cómo comprobar que funciona

qc status muestra versiones de paquete, motor y protocolo; el mapa devuelve una vista acotada y la búsqueda de una frase indexada recupera su texto. Esto no prueba por sí solo que el daemon o el cliente estén conectados.

Pide a tu agente que lo configure

Copia esto en un agente de programación con acceso a tu entorno. El prompt le pide consultar las instrucciones actuales y verificar la instalación antes de darla por terminada.

También puedes seleccionar y copiar el texto directamente.

Qué debes saber antes

El paquete documentado es una versión candidata. Usa Elastic License 2.0, no MIT. Los comandos conservan los permisos del usuario; compactar salidas no crea un entorno aislado ni garantiza ahorro de tokens.

README actual del proyecto

AgentesHerramientas para desarrolladores