{ "@context": "https://schema.org", "@id": "https://aggr.aymericbeaumet.com/items/ampcode-com/2025-09-09-streaming-json/#webpage", "@type": [ "WebPage", "ArchiveComponent" ], "articleBody": "The Amp CLI has two new flags: `--stream-json` and `--stream-json-input`.\n\nThey can be used together with the `--execute` flag to turn on structured JSON output and input, respectively.\n\nHere is an example:\n\n```shell-session\n$ amp --execute \"what is 2+2?\" --stream-json\n```\n\nThis would print something like the following on stdout:\n\n```\n{\"type\":\"system\",\"subtype\":\"init\",\"cwd\":\"/Users/mrnugget/work/amp\",\"session_id\":\"T-2775dc92-90ed-4f85-8b73-8f9766029e83\",\"tools\":[\"oracle\",\"...\"],\"mcp_servers\":[]}\n{\"type\":\"user\",\"message\":{\"role\":\"user\",\"content\":[{\"type\":\"text\",\"text\":\"what is 2+2?\"}]},\"parent_tool_use_id\":null,\"session_id\":\"T-2775dc92-90ed-4f85-8b73-8f9766029e83\"}\n{\"type\":\"assistant\",\"message\":{\"type\":\"message\",\"role\":\"assistant\",\"content\":[{\"type\":\"text\",\"text\":\"2 + 2 equals 4.\"}],\"stop_reason\":\"end_turn\",\"usage\":{\"input_tokens\":12783,\"cache_creation_input_tokens\":367,\"cache_read_input_tokens\":12416,\"output_tokens\":8,\"max_tokens\":224000,\"service_tier\":\"standard\"}},\"parent_tool_use_id\":null,\"session_id\":\"T-2775dc92-90ed-4f85-8b73-8f9766029e83\"}\n{\"type\":\"result\",\"subtype\":\"success\",\"duration_ms\":2906,\"is_error\":false,\"num_turns\":1,\"result\":\"2 + 2 equals 4.\",\"session_id\":\"T-2775dc92-90ed-4f85-8b73-8f9766029e83\"}\n```\n\nStructured input can be provided on stdin with the `--stream-json-input` flag:\n\n```shell-session\n$ echo '{\n \"type\": \"user\",\n \"message\": {\n \"role\": \"user\",\n \"content\": [\n {\n \"type\": \"text\",\n \"text\": \"what is 2+2?\"\n }\n ]\n }\n}' | amp -x --stream-json --stream-json-input\n```\n\nIf `--stream-json-input` is set, the Amp CLI will process user messages as soon as they are received on stdin and exit as soon as stdin is closed and the agent has ended its turns.\n\nCombined with `amp threads continue [thread]`, multi-turn conversations can even happen across multiple invocations of the CLI:\n\n```shell-session\n$ amp -x \"what is 2+2?\" --stream-json\n...\n$ amp threads continue -x \"and now add 7 to that\" --stream-json\n...\n{\"type\":\"result\",\"result\":\"11.\", \"subtype\":\"success\",\"duration_ms\":2906,\"is_error\":false,\"num_turns\":2,\"session_id\":\"T-2775dc92-90ed-4f85-8b73-8f9766029e83\"}\n```\n\nSee the [Manual](https://ampcode.com/manual#cli-streaming-json) for more details and the [Appendix](https://ampcode.com/manual/appendix#stream-json-output) for the full schema.\n", "authors": [], "captured_at": "2026-10-04T12:50:30.804479567+00:00", "category": "programming", "content_html": "

The Amp CLI has two new flags: --stream-json and --stream-json-input.

\n

They can be used together with the --execute flag to turn on structured JSON output and input, respectively.

\n

Here is an example:

\n
$ amp --execute "what is 2+2?" --stream-json\n
\n

This would print something like the following on stdout:

\n
{"type":"system","subtype":"init","cwd":"/Users/mrnugget/work/amp","session_id":"T-2775dc92-90ed-4f85-8b73-8f9766029e83","tools":["oracle","..."],"mcp_servers":[]}\n{"type":"user","message":{"role":"user","content":[{"type":"text","text":"what is 2+2?"}]},"parent_tool_use_id":null,"session_id":"T-2775dc92-90ed-4f85-8b73-8f9766029e83"}\n{"type":"assistant","message":{"type":"message","role":"assistant","content":[{"type":"text","text":"2 + 2 equals 4."}],"stop_reason":"end_turn","usage":{"input_tokens":12783,"cache_creation_input_tokens":367,"cache_read_input_tokens":12416,"output_tokens":8,"max_tokens":224000,"service_tier":"standard"}},"parent_tool_use_id":null,"session_id":"T-2775dc92-90ed-4f85-8b73-8f9766029e83"}\n{"type":"result","subtype":"success","duration_ms":2906,"is_error":false,"num_turns":1,"result":"2 + 2 equals 4.","session_id":"T-2775dc92-90ed-4f85-8b73-8f9766029e83"}\n
\n

Structured input can be provided on stdin with the --stream-json-input flag:

\n
$ echo '{\n  "type": "user",\n  "message": {\n    "role": "user",\n    "content": [\n      {\n        "type": "text",\n        "text": "what is 2+2?"\n      }\n    ]\n  }\n}' | amp -x --stream-json --stream-json-input\n
\n

If --stream-json-input is set, the Amp CLI will process user messages as soon as they are received on stdin and exit as soon as stdin is closed and the agent has ended its turns.

\n

Combined with amp threads continue [thread], multi-turn conversations can even happen across multiple invocations of the CLI:

\n
$ amp -x "what is 2+2?" --stream-json\n...\n$ amp threads continue -x "and now add 7 to that" --stream-json\n...\n{"type":"result","result":"11.", "subtype":"success","duration_ms":2906,"is_error":false,"num_turns":2,"session_id":"T-2775dc92-90ed-4f85-8b73-8f9766029e83"}\n
\n

See the Manual for more details and the Appendix for the full schema.

\n", "content_markdown": "The Amp CLI has two new flags: `--stream-json` and `--stream-json-input`.\n\nThey can be used together with the `--execute` flag to turn on structured JSON output and input, respectively.\n\nHere is an example:\n\n```shell-session\n$ amp --execute \"what is 2+2?\" --stream-json\n```\n\nThis would print something like the following on stdout:\n\n```\n{\"type\":\"system\",\"subtype\":\"init\",\"cwd\":\"/Users/mrnugget/work/amp\",\"session_id\":\"T-2775dc92-90ed-4f85-8b73-8f9766029e83\",\"tools\":[\"oracle\",\"...\"],\"mcp_servers\":[]}\n{\"type\":\"user\",\"message\":{\"role\":\"user\",\"content\":[{\"type\":\"text\",\"text\":\"what is 2+2?\"}]},\"parent_tool_use_id\":null,\"session_id\":\"T-2775dc92-90ed-4f85-8b73-8f9766029e83\"}\n{\"type\":\"assistant\",\"message\":{\"type\":\"message\",\"role\":\"assistant\",\"content\":[{\"type\":\"text\",\"text\":\"2 + 2 equals 4.\"}],\"stop_reason\":\"end_turn\",\"usage\":{\"input_tokens\":12783,\"cache_creation_input_tokens\":367,\"cache_read_input_tokens\":12416,\"output_tokens\":8,\"max_tokens\":224000,\"service_tier\":\"standard\"}},\"parent_tool_use_id\":null,\"session_id\":\"T-2775dc92-90ed-4f85-8b73-8f9766029e83\"}\n{\"type\":\"result\",\"subtype\":\"success\",\"duration_ms\":2906,\"is_error\":false,\"num_turns\":1,\"result\":\"2 + 2 equals 4.\",\"session_id\":\"T-2775dc92-90ed-4f85-8b73-8f9766029e83\"}\n```\n\nStructured input can be provided on stdin with the `--stream-json-input` flag:\n\n```shell-session\n$ echo '{\n \"type\": \"user\",\n \"message\": {\n \"role\": \"user\",\n \"content\": [\n {\n \"type\": \"text\",\n \"text\": \"what is 2+2?\"\n }\n ]\n }\n}' | amp -x --stream-json --stream-json-input\n```\n\nIf `--stream-json-input` is set, the Amp CLI will process user messages as soon as they are received on stdin and exit as soon as stdin is closed and the agent has ended its turns.\n\nCombined with `amp threads continue [thread]`, multi-turn conversations can even happen across multiple invocations of the CLI:\n\n```shell-session\n$ amp -x \"what is 2+2?\" --stream-json\n...\n$ amp threads continue -x \"and now add 7 to that\" --stream-json\n...\n{\"type\":\"result\",\"result\":\"11.\", \"subtype\":\"success\",\"duration_ms\":2906,\"is_error\":false,\"num_turns\":2,\"session_id\":\"T-2775dc92-90ed-4f85-8b73-8f9766029e83\"}\n```\n\nSee the [Manual](https://ampcode.com/manual#cli-streaming-json) for more details and the [Appendix](https://ampcode.com/manual/appendix#stream-json-output) for the full schema.\n", "dateCreated": "2026-10-04T12:50:30.804479567+00:00", "date_created": "2025-09-09T00:00:00+00:00", "date_modified": "2025-09-09T00:00:00+00:00", "date_published": "2025-09-09T00:00:00+00:00", "description": "The Amp CLI has two new flags: --stream-json and --stream-json-input. They can be used together with the --execute flag to turn on structured JSON output and input, respectively. Here is an example: $ amp --execute \"what is 2+2?\"…", "external_url": "https://ampcode.com/news/streaming-json", "git": { "commit": "ebb0941c5c06a2ab2377342d607535262a3e969e", "path": "items/ampcode-com/2025/09/2025-09-09-streaming-json.md", "permalink": "https://github.com/aymericbeaumet/aggr-instance/blob/ebb0941c5c06a2ab2377342d607535262a3e969e/items/ampcode-com/2025/09/2025-09-09-streaming-json.md" }, "id": "urn:aggr:item:e8424a0aa50b615845e2a3bb0d610dbc1e0ebc00", "isBasedOn": { "@id": "https://ampcode.com/news/streaming-json" }, "mainEntity": { "@id": "https://ampcode.com/news/streaming-json", "@type": "CreativeWork", "archivedAt": { "@id": "https://aggr.aymericbeaumet.com/items/ampcode-com/2025-09-09-streaming-json/#webpage" }, "dateModified": "2025-09-09T00:00:00+00:00", "datePublished": "2025-09-09T00:00:00+00:00", "headline": "Streaming JSON", "timeRequired": "PT2M", "url": "https://ampcode.com/news/streaming-json", "wordCount": 294 }, "name": "Archived snapshot: Streaming JSON", "preview": null, "reading_minutes": 2, "replicated_at": null, "source": "ampcode-com", "source_name": "Amp News", "summary": "The Amp CLI has two new flags: --stream-json and --stream-json-input. They can be used together with the --execute flag to turn on structured JSON output and input, respectively. Here is an example: $ amp --execute \"what is 2+2?\" --stream-json This would print something like the following on stdout: {\"type\":\"system\",\"subtype\":\"init\",\"cwd\":\"/Users/mrnugget/work/amp\",\"session_id\":\"T-2775dc92-90ed-4f85-8b73-8f9766029e83\",\"tools\":[\"oracle\",\"...\"],\"mcp_servers\":[]} {\"type\":\"user\",\"message\":{\"role\":\"user\",\"content\":[{\"type\":\"text\",\"text\":\"what is 2+2?\"}]},\"parent_tool_use_id\":null,\"session_id\":\"T-2775dc92-90ed-4f85-8b73-8f9766029e83\"} {\"type\":\"assistant\",\"message\":{\"type\":\"message\",\"role\":\"assistant\",\"content\":[{\"type\":\"text\",\"text\":\"2 + 2 equals 4.\"}],\"stop_reason\":\"end_turn\",\"usage\":{\"input_tokens\":12783,\"cache_creation_input_tokens\":367,\"cache_read_input_tokens\":12416,\"output_tokens\":8,\"max_tokens\":224000,\"service_tier\":\"standard\"}},\"parent_tool_use_id\":null,\"session_id\":\"T-2775dc92-90ed-4f85-8b73-8f9766029e83\"} {\"type\":\"result\",\"subtype\":\"success\",\"duration_ms\":2906,\"is_error\":false,\"num_turns\":1,\"result\":\"2 + 2 equals 4.\",\"session_id\":\"T-2775dc92-90ed-4f85-8b73-8f9766029e83\"} Structured input can be provided on stdin with the --stream-json-input flag: $ echo '{ \"type\": \"user\", \"message\": { \"role\": \"user\", \"content\": [ { \"type\": \"text\", \"text\": \"what is 2+2?\" } ] } }' | amp -x --stream-json --stream-json-input If --stream-json-input is set, the Amp CLI will process user messages as soon as they are received on stdin and exit as soon as stdin is closed and the agent has ended its turns. Combined with amp threads continue [thread], multi-turn conversations can even happen across multiple invocations of the CLI: $ amp -x \"what is 2+2?\" --stream-json ... $ amp threads continue -x \"and now add 7 to that\" --stream-json ... {\"type\":\"result\",\"result\":\"11.\", \"subtype\":\"success\",\"duration_ms\":2906,\"is_error\":false,\"num_turns\":2,\"session_id\":\"T-2775dc92-90ed-4f85-8b73-8f9766029e83\"} See the Manual for more details and the Appendix for the full schema.", "tags": [], "temporalCoverage": "2026-10-04T12:50:30.804479567+00:00", "title": "Streaming JSON", "url": "https://aggr.aymericbeaumet.com/items/ampcode-com/2025-09-09-streaming-json/", "word_count": 294 }