Giustizia Amministrativa CLI

La giurisprudenza amministrativa italiana (TAR, Consiglio di Stato) da terminale: ricerca, testo integrale in Markdown, store locale e ricerca offline.

Cerca sentenze, ordinanze, decreti e pareri con filtri per tipo, sede e anno; ottieni il testo integrale in Markdown pulito con il suo URL pubblico; accumula i risultati in un database SQLite locale per ricerca offline, monitoraggio nel tempo ed export di corpus.

Learn more at Giustizia Amministrativa.

Created by @aborruso (aborruso).

Authentication

Nessuna autenticazione: ricerca e testi sono pubblici. Il CLF gestisce internamente l'handshake di sessione (token p_auth + cookie) del portale.

Quick Start

# ricerca filtrata, ogni risultato porta ECLI e url pubblico
giustizia-amministrativa-pp-cli search "appalto soccorso istruttorio" --tipo sentenza --sede roma --limit 10

# testo integrale in Markdown pulito
giustizia-amministrativa-pp-cli get IT:TARLAZ:2026:11307SENT --format md

# output agent-native filtrato sui campi utili
giustizia-amministrativa-pp-cli search "clausola sociale" --all --json --select ecli,tipo,sede,data,url

Unique Features

These capabilities aren't available in any other tool for this API.

Output agent-native

• get — Scarica il testo completo di una sentenza/ordinanza/decreto/parere e lo restituisce in Markdown pulito.

  Quando l'agente deve leggere o citare il testo di un provvedimento senza rumore HTML.

  giustizia-amministrativa-pp-cli get --sede tar_rm --nrg 202600422 --file 202611307_01.html --format md
  

Stato locale che si accumula

• watch run — Salva una ricerca e a ogni esecuzione mostra solo i provvedimenti nuovi dall'ultima volta.

  Per monitorare nuove decisioni su un tema o una sede senza rileggere tutto.

  giustizia-amministrativa-pp-cli watch run appalti-rm --testo appalto --sede roma --limit 20
  

• corpus build — Assembla N provvedimenti su un tema in una cartella di Markdown + un CSV manifest (ECLI, sede, data, url).

  Per costruire un fascicolo citabile o un dataset di ricerca in un colpo solo.

  giustizia-amministrativa-pp-cli corpus build --testo "soccorso istruttorio" --tipo sentenza --limit 3 --out ./corpus
  

Ricerca offline

• grep — Ricerca regex/prossimita' sui testi integrali scaricati localmente, non solo sugli snippet.

  Per trovare una frase normativa esatta dentro il corpo dei provvedimenti.

  giustizia-amministrativa-pp-cli grep -e "soccorso istruttorio" --select ecli,url
  

• massime — Estrae i paragrafi 'principio di diritto'/massima da un corpus in un unico digest.

  Per ottenere i principi di diritto su un tema senza leggere ogni sentenza.

  giustizia-amministrativa-pp-cli massime --testo "clausola sociale" --limit 30
  

Analisi sul corpus

• appeal-chain — Esegue il 'verifica appello' in batch e ricostruisce la catena TAR->Consiglio di Stato.

  Per sapere quali sentenze di primo grado sono state appellate e con quale esito.

  giustizia-amministrativa-pp-cli appeal-chain --testo "project financing" --limit 40
  

• stats — Distribuzione di un tema per sede, sezione, tipo e anno.

  Per capire quale sede/sezione decide un tema e se il volume cresce.

  giustizia-amministrativa-pp-cli stats --testo "appalto" --by sede,anno
  

Recipes

Testo integrale in markdown

giustizia-amministrativa-pp-cli get IT:TARLAZ:2026:11307SENT --format md

Recupera e converte in Markdown pulito il provvedimento.

Output agent-native con select su risposta ricca

giustizia-amministrativa-pp-cli search "appalto" --all --json --select results.ecli,results.tipo,results.sede,results.url

Restringe i campi della risposta ricca della ricerca per non sprecare contesto.

Monitoraggio nel tempo

giustizia-amministrativa-pp-cli watch run appalti-lazio --json

Mostra solo i provvedimenti nuovi dall'ultima esecuzione.

Usage

Run giustizia-amministrativa-pp-cli --help for the full command reference and flag list.

Commands

provvedimenti

Provvedimenti (sentenze, ordinanze, decreti, pareri) di TAR, Consiglio di Stato e CGARS.

• giustizia-amministrativa-pp-cli provvedimenti cerca - Cerca provvedimenti per testo, tipo, sede, anno, numero o NRG.
• giustizia-amministrativa-pp-cli provvedimenti get - Scarica il testo integrale di un provvedimento.

Output Formats

# Human-readable table (default in terminal, JSON when piped)
giustizia-amministrativa-pp-cli provvedimenti get mock-value

# JSON for scripting and agents
giustizia-amministrativa-pp-cli provvedimenti get mock-value --json

# Filter to specific fields
giustizia-amministrativa-pp-cli provvedimenti get mock-value --json --select id,name,status

# Dry run — show the request without sending
giustizia-amministrativa-pp-cli provvedimenti get mock-value --dry-run

# Agent mode — JSON + compact + no prompts in one flag
giustizia-amministrativa-pp-cli provvedimenti get mock-value --agent

Agent Usage

This CLI is designed for AI agent consumption:

• Non-interactive - never prompts, every input is a flag
• Pipeable - --json output to stdout, errors to stderr
• Filterable - --select id,name returns only fields you need
• Previewable - --dry-run shows the request without sending
• Read-only by default - this CLI does not create, update, delete, publish, send, or mutate remote resources
• Offline-friendly - sync/search commands can use the local SQLite store when available
• Agent-safe by default - no colors or formatting unless --human-friendly is set

Exit codes: 0 success, 2 usage error, 3 not found, 5 API error, 7 rate limited, 10 config error.

Health Check

giustizia-amministrativa-pp-cli doctor

Verifies configuration and connectivity to the API.

Configuration

Config file: ~/.config/giustizia-amministrativa-pp-cli/config.toml

Static request headers can be configured under headers; per-command header overrides take precedence.

Troubleshooting

Not found errors (exit code 3)

• Check the resource ID is correct
• Run the list command to see available items

API-specific

• 403 sulle ricerche — il token p_auth e' scaduto: il CLI lo rinnova automaticamente al refresh dell'handshake; riprova.
• nessun risultato per una query certa — verifica i filtri --tipo/--sede e prova la ricerca avanzata --all/--phrase.