Edición en Markdown

AI-translated from English; not yet reviewed by a fluent editor.

# Audita una sesión de un agente de programación con AgentsView

> Encuentra en AgentsView una transcripción local conocida de un agente de programación, examina los tokens registrados y la procedencia del coste, y consulta un informe diario acotado sin tratar las estimaciones como facturas.

By BIG CHANGE Editorial

Published: 2026-10-17T17:20:34.907Z
Updated: 2026-10-17T17:20:34.907Z
Canonical: https://bigchange.ai/blog/audit-coding-agent-session-agentsview

![Conceptual charcoal illustration of a local computer with one blank transcript line highlighted and an external drive beside it.](https://bigchange.ai/api/media/file/agentsview-local-session-audit-concept-v1.png)
AI-generated conceptual illustration by BIG CHANGE; no actual AgentsView interface, transcript, usage figure or billing result is depicted.

AgentsView puede reunir los registros de sesiones de agentes de programación de varias herramientas en un archivo local con búsqueda. Esta guía está dirigida a un responsable de ingeniería que necesita encontrar una tarea conocida, examinar los campos de uso que su agente realmente registró e identificar el origen de cualquier cifra de coste.

Este recorrido se basa en la documentación de la versión v0.45.0 de AgentsView, publicada el 9 de octubre de 2026, y en las guías actuales de inicio rápido y uso de tokens, consultadas el 17 de octubre. BIG CHANGE no ha instalado AgentsView, importado una transcripción ni probado estos pasos. Comprueba la versión que instales, ya que la documentación y los listados de versiones pueden cambiar.

## Antes de empezar

Necesitas una sesión terminada de un agente de programación que tengas autorización para leer, una frase distintiva o el ID de esa tarea y permiso para leer su directorio local de registros. La guía [Quick Start](https://www.agentsview.io/docs/quickstart/) enumera descargas de escritorio para macOS, Windows y Linux, con paquetes wheel de la CLI para Linux x86\_64 y aarch64, macOS x86\_64 y arm64, y Windows x86\_64 y arm64. La aplicación de escritorio viene empaquetada; compilar desde el código fuente exige por separado Go, Node y CGO. El archivado local básico no requiere una cuenta alojada ni una clave de API según la guía de inicio rápido.

Los registros de sesión pueden contener prompts, código fuente, entradas de herramientas y secretos. Elige solo directorios que tu equipo te permita examinar. Decide qué proveedores y directorios raíz puede incorporar el archivo **antes de su primer inicio**: ejecutar sin opciones `agentsview serve` descubre y sincroniza de inmediato las fuentes compatibles predeterminadas. Mantén la interfaz web en la dirección de bucle local documentada para este ejercicio. No actives sincronización remota de datos sin procesar, envíos a PostgreSQL o ClickHouse, publicación en Gist, informes generados ni un servicio alojado de embeddings solo para responder esta pregunta. La búsqueda semántica es opcional; la búsqueda normal de texto completo funciona con el índice local.

## 1. Instala e identifica el ejecutable

Elige un método de la [guía de instalación](https://www.agentsview.io/docs/quickstart/). Para una CLI independiente, la instalación permanente con Python documentada es:

```sh
pip install agentsview
agentsview --version
```

La guía también ofrece `uvx agentsview` para ejecutar sin una instalación permanente, además de instaladores por plataforma y paquetes de escritorio. En macOS, el cask de Homebrew enlaza la CLI incluida en la aplicación; una aplicación instalada desde un DMG puede requerir añadir el directorio de su CLI a `PATH`. Confirma qué ejecutable encuentra tu intérprete antes de fiarte de su versión. GitHub identifica [v0.45.0](https://github.com/kenn-io/agentsview/releases/tag/v0.45.0) como su versión del 9 de octubre, pero utiliza tu propio resultado de `--version` al interpretar las pantallas y el esquema del informe.

## 2. Restringe las fuentes antes de la primera sincronización

Para una instalación de la CLI o de escritorio en el equipo anfitrión, prepara un directorio de datos nuevo y su `config.toml` **antes de** iniciar AgentsView. La [guía de configuración](https://www.agentsview.io/docs/configuration/#disabling-session-providers) documenta `disabled_agents` para excluir proveedores del sistema de archivos local y `[agents.<id>].dirs` para sustituir los directorios raíz predeterminados de un proveedor. Enumera **todos los ID de los demás proveedores** de la [tabla Session Discovery](https://www.agentsview.io/docs/configuration/#session-discovery) de esa guía en `disabled_agents`, y establece el `dirs` del único proveedor autorizado en el directorio raíz aprobado. Por ejemplo, `[agents.codex]` con `dirs = ["/approved/codex/sessions"]` sustituye los directorios predeterminados de Codex; adapta la ruta a tu sistema. Si no tienes una lista de exclusión completa, todavía no inicies el demonio del equipo anfitrión. Una única redefinición de `CODEX_SESSIONS_DIR` o `CLAUDE_PROJECTS_DIR` cambia la raíz de ese proveedor, pero deja a los demás habilitados para su descubrimiento predeterminado.

Usa un `AGENTSVIEW_DATA_DIR` nuevo para esta auditoría si un archivo existente puede contener sesiones ajenas a la tarea. La guía de configuración dice que las sesiones ya archivadas de proveedores deshabilitados siguen disponibles, por lo que cambiar la configuración no vacía un archivo anterior. También indica que `disabled_agents` abarca el descubrimiento y la vigilancia locales, no las importaciones ni exportaciones remotas; deja sin configurar los equipos remotos y destinos de exportación para esta tarea local.

Un contenedor aislado es la alternativa cuando no resulta práctico mantener una lista de exclusión de todos los demás proveedores. El [ejemplo de Docker de Quick Start](https://www.agentsview.io/docs/quickstart/#docker) expone la interfaz únicamente en `127.0.0.1`, monta una fuente de un agente en modo de solo lectura y usa un volumen de datos separado. Monta **solo** la raíz de la fuente autorizada y configura su variable de directorio correspondiente dentro de un contenedor nuevo; omite los demás montajes del [ejemplo de Compose del proyecto](https://github.com/kenn-io/agentsview/blob/main/docker-compose.prod.yaml). Un contenedor solo ve los directorios de sesiones del anfitrión que se hayan montado explícitamente. Las imágenes Docker publicadas cubren Linux amd64 y arm64; esta vía requiere una instalación funcional de Docker.

## 3. Crea el archivo local

Para la CLI del anfitrión con el alcance ya restringido, inicia el servidor en primer plano documentado:

```sh
agentsview serve
```

Después de aplicar y comprobar el alcance de las fuentes en el paso 2, esto inicializa `~/.agentsview/sessions.db` —o el directorio de datos elegido—, descubre los registros de agentes habilitados, los sincroniza, vigila los cambios y abre `http://127.0.0.1:8080`. Deja esa terminal abierta. Si prefieres un proceso en segundo plano, usa `agentsview daemon start` y `agentsview daemon status`; la aplicación de escritorio gestiona su propio backend. Un servidor compatible que ya esté funcionando puede limitarse a comunicar su URL; comprueba, por tanto, si hay un demonio activo antes de asumir que la nueva configuración rigió la incorporación de datos.

Si elegiste el contenedor aislado, inícialo con el comando Docker documentado después de comprobar su único montaje de fuente de solo lectura y el volumen de datos nuevo. Usa su interfaz de bucle local y ejecuta los informes posteriores de la CLI de `agentsview` dentro de ese contenedor para que lean el mismo archivo. No ejecutes a la vez un `serve` del anfitrión sin restricciones de alcance.

Comprueba que aparece la fuente de la tarea conocida y que no aparecen proveedores no deseados. Si falta la sesión, revisa la ruta aprobada, la configuración del proveedor y el estado de sincronización antes de concluir que no existe ninguna sesión. Ejecuta `agentsview sync` cuando necesites incorporar los archivos recién modificados antes de un informe; el servidor también vigila los cambios. Vuelve a comprobar el alcance configurado antes de cualquier resincronización completa.

## 4. Encuentra la tarea y verifica la transcripción

En la interfaz web, usa `Ctrl/Cmd+K` para buscar una frase literal distintiva de la tarea conocida. Acota la lista por proyecto, agente o fecha, abre el resultado candidato y comprueba sus mensajes y llamadas a herramientas. Si ya tienes el ID completo de la sesión o su UUID, `Ctrl/Cmd+G` la abre directamente. Estos controles se documentan en [Quick Start](https://www.agentsview.io/docs/quickstart/). Registra el agente, el ID de sesión y la fecha para poder vincular el resultado de uso con la conversación correcta.

Si la búsqueda literal no encuentra la tarea, prueba una frase más corta y confirma que el agente subyacente escribió una transcripción local en un directorio que AgentsView pueda leer. Una tarea que solo existe en un servicio remoto, un formato no compatible o un directorio fuera de las raíces configuradas no se recupera buscando más. No actives la indexación semántica ni la carga de transcripciones como solución habitual a una fuente local ausente.

## 5. Examina los campos de uso de la sesión

Abre la vista de uso de la sesión encontrada e identifica los campos registrados de modelo, entrada, salida, creación de caché y lectura de caché que estén presentes. La [guía de uso de tokens](https://www.agentsview.io/docs/token-usage/) describe los informes de costes como **experimentales y todavía en evolución**. AgentsView incorpora metadatos de modelos y tokens desde los registros originales y conserva el uso de tokens sin procesar en las filas de mensajes. Usa los costes explícitos que comunique la fuente cuando estén disponibles; en caso contrario, calcula un coste a partir de los tokens utilizables y las tarifas del modelo. Su información de procedencia en JSON los denomina `reported`, `computed` o `mixed`.

Si quieres conservar un registro legible por máquina de esa única sesión, el [ejemplo de CLI del proyecto](https://www.agentsview.io/) usa `agentsview session usage SESSION_ID --format json`. Sustituye `SESSION_ID` por el ID que verificaste en la transcripción y guarda el JSON junto a la nota de la tarea. Comprueba el modelo comunicado, las categorías de tokens y la fuente del coste en esa salida antes de citar un total.

Trata un campo vacío o un modelo ausente como desconocido. AgentsView no puede reconstruir uso que el agente nunca registró. Sus notas de versión dicen que la importación de Junie CLI excluye conversaciones y llamadas a herramientas que solo existen en el IDE, mientras que la alternativa de texto plano de Antigravity contiene la transcripción sin uso de tokens ni costes. Son ejemplos concretos de por qué una sesión localizable no tiene por qué ofrecer una cifra completa de gasto. Un importe comunicado por la fuente también puede describir el total de una sesión mientras los repartos por modelo siguen siendo estimaciones.

## 6. Acota el informe diario

Usa los filtros de fecha, proyecto y agente de la página Usage para examinar el día de la sesión. La página también ofrece una tabla Top Sessions by Cost con enlaces a las transcripciones individuales. Para un informe auditable en la terminal, sustituye la fecha local y el nombre del agente de la sesión en:

```sh
agentsview usage daily --since YYYY-MM-DD --until YYYY-MM-DD --agent codex --breakdown
```

La tabla diaria separa entrada sin caché, salida, creación de caché y lecturas de caché, con filas por modelo cuando se activa `--breakdown`. La fecha se agrupa según la zona horaria del sistema salvo que se indique `--timezone`. El total de un día puede incluir otras sesiones de ese agente; sirve para comprobar el alcance y la magnitud, no es el coste de una sola tarea. Conserva el ID de sesión junto al informe diario y comprueba qué filas le corresponden realmente.

Para generar un informe sin consultar el catálogo de precios, añade `--offline`. AgentsView dice que esto lee el archivo existente sin sincronizar fuentes ni iniciar el demonio y usa sus precios integrados de respaldo. Actualiza antes el archivo si importan los cambios recientes de la sesión; un informe sin conexión no puede descubrir registros nuevos. Los comandos normales de uso pueden consultar precios de LiteLLM y OpenRouter, mientras que el catálogo integrado envejece con la versión instalada.

## 7. Interpreta la cifra y detén el servicio

Etiqueta cada cifra según su procedencia. `Computed` significa que AgentsView multiplicó los tokens registrados por las tarifas seleccionadas. `Reported` significa que la fuente proporcionó un coste explícito. `Mixed` significa que el informe combina tipos. Incluso una cifra comunicada por la fuente no demuestra que se haya conciliado una factura del proveedor para toda la cuenta. Compara por separado los registros de facturación o del plan del proveedor pertinente, sobre todo cuando importen niveles de servicio, descuentos o asignaciones de una suscripción. La documentación de AgentsView dice que no puede inferir tarifas Batch, Flex, Priority, regionales o de caché de una hora cuando el uso almacenado omite ese nivel. Algunos tokens de las herramientas no aparecen en las transcripciones locales.

La comprobación de éxito es una transcripción encontrada cuyo agente, ID y fecha coincidan con la vista de uso seleccionada, con los campos de modelo y tokens disponibles registrados y los no disponibles marcados como desconocidos. El resultado es un archivo local con búsqueda y una nota acotada de uso de la tarea o del día, no una factura. Detén un `agentsview serve` en primer plano con `Ctrl+C`, o un servidor en segundo plano con `agentsview daemon stop`. La guía [Quick Start](https://www.agentsview.io/docs/quickstart/) dice que detener el demonio detiene tanto la interfaz web como el observador de sesiones.

## El gran cambio

Una transcripción local ofrece un punto de partida rastreable para hablar de costes. El responsable de ingeniería puede seguir una cifra hasta una tarea registrada concreta y ver si procede del agente o de un catálogo de precios. Si el registro está incompleto, el informe debe conservar esa laguna.

## Fuentes y lecturas adicionales

- [Notas de la versión v0.45.0 de AgentsView](https://github.com/kenn-io/agentsview/releases/tag/v0.45.0): cambios fechados en la compatibilidad con agentes, las tarjetas Usage, la sincronización y el comportamiento de los precios. Una nota de versión es un registro del proveedor, no una prueba de BIG CHANGE.
- [AgentsView Quick Start](https://www.agentsview.io/docs/quickstart/): vías de instalación compatibles, comandos de servidor y demonio, configuración de fuentes y controles de búsqueda local.
- [Configuración de AgentsView](https://www.agentsview.io/docs/configuration/): descubrimiento de fuentes, exclusión de proveedores, ubicación del archivo y límites de esos controles.
- [Uso de tokens y costes de AgentsView](https://www.agentsview.io/docs/token-usage/): compatibilidad de fuentes, informes de uso, procedencia de precios, modo sin conexión y limitaciones conocidas de los informes.
- [Repositorio de AgentsView](https://github.com/kenn-io/agentsview): código fuente y licencia MIT; el repositorio describe el archivo predeterminado como local.

## Sources

- [Notas de la versión v0.45.0 de AgentsView](https://github.com/kenn-io/agentsview/releases/tag/v0.45.0) — Versión fechada y cambios de funciones y compatibilidad.
- [AgentsView Quick Start](https://www.agentsview.io/docs/quickstart/) — Instalación, ejecución, selección de fuentes y controles de búsqueda.
- [Configuración de AgentsView](https://www.agentsview.io/docs/configuration/) — Descubrimiento de fuentes, exclusiones de proveedores, directorio de datos y límites de los controles.
- [Uso de tokens y costes de AgentsView](https://www.agentsview.io/docs/token-usage/) — Informes de uso experimentales, procedencia de precios y limitaciones.
- [Repositorio de código fuente de AgentsView](https://github.com/kenn-io/agentsview) — Código fuente, descripción del proyecto y licencia MIT.