Skip to content

Bootstrap praxis init with messages and responses starters#642

Closed
franciscojavierarceo wants to merge 1 commit into
praxis-proxy:mainfrom
franciscojavierarceo:codex/praxis-init-responses-bootstrap
Closed

Bootstrap praxis init with messages and responses starters#642
franciscojavierarceo wants to merge 1 commit into
praxis-proxy:mainfrom
franciscojavierarceo:codex/praxis-init-responses-bootstrap

Conversation

@franciscojavierarceo

@franciscojavierarceo franciscojavierarceo commented Jun 19, 2026

Copy link
Copy Markdown
Collaborator

Summary

Bootstrap praxis init with a small, truthful first slice aimed at issue praxis-proxy/config-generator#1.

This PR adds:

  • a new praxis init <family> <recipe> CLI surface
  • real starter generation for:
    • messages protocol
    • messages to-openai
    • responses passthrough
    • responses full-flow
  • friendly next-step output after writing praxis.yaml
  • quickstart docs for the new bootstrap flow
  • unit tests for CLI parsing and file generation behavior

Why

Issue praxis-proxy/config-generator#1 proposes a starter-config CLI that makes Praxis easier to try without starting from a blank YAML file.

This PR establishes the command framework and ships the first recipes from maintained in-repo examples for both Anthropic Messages and OpenAI Responses workflows.

Scope notes

This is still the first slice of the broader epic:

  • the framework is general, but the initial shipped families are messages and responses
  • interactive setup is still out of scope for v1
  • the command currently writes praxis.yaml in the working directory and refuses to overwrite existing files

Validation

  • cargo test -p praxis
  • cargo run -q -p praxis -- init messages --help
  • end-to-end smoke run: cargo run -q --manifest-path server/Cargo.toml -- init messages protocol in a temp dir and verified the generated praxis.yaml
  • end-to-end smoke run: cargo run -q --manifest-path server/Cargo.toml -- init responses passthrough in a temp dir and verified the generated praxis.yaml

Closes praxis-proxy/config-generator#1

@franciscojavierarceo franciscojavierarceo changed the title [codex] Bootstrap \ with responses starters [codex] Bootstrap praxis init with responses starters Jun 19, 2026
@franciscojavierarceo franciscojavierarceo changed the title [codex] Bootstrap praxis init with responses starters feat(cli): Bootstrap praxis init with responses starters Jun 19, 2026
@franciscojavierarceo franciscojavierarceo changed the title feat(cli): Bootstrap praxis init with responses starters Bootstrap praxis init with responses starters Jun 19, 2026
@franciscojavierarceo franciscojavierarceo changed the title Bootstrap praxis init with responses starters feat(cli): Bootstrap praxis init with responses starters Jun 19, 2026
@franciscojavierarceo franciscojavierarceo changed the title feat(cli): Bootstrap praxis init with responses starters feat(cli): Bootstrap praxis init with responses and messages starters Jun 19, 2026
@franciscojavierarceo franciscojavierarceo force-pushed the codex/praxis-init-responses-bootstrap branch from a584df6 to 5b42539 Compare June 19, 2026 18:55
@franciscojavierarceo franciscojavierarceo changed the title feat(cli): Bootstrap praxis init with responses and messages starters Bootstrap praxis init with messages and responses starters Jun 19, 2026
Signed-off-by: Francisco Javier Arceo <farceo@redhat.com>
@franciscojavierarceo franciscojavierarceo force-pushed the codex/praxis-init-responses-bootstrap branch from 08519e4 to a1009ae Compare June 20, 2026 02:44
@shaneutt

Copy link
Copy Markdown
Member

I like the idea, but separating it and letting it soak and grow on its own for a bit will be helpful for cognitive load. I've moved the epic over to a new repository: praxis-proxy/config-generator#1 let's move this over there 👍

@shaneutt shaneutt closed this Jun 22, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

EPIC: Add starter-config CLI with friendly help UX

2 participants