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.