Skip to content
v0.3.0MIT

Run structured stimulus-task-response polls against simulated respondent cohorts using Jev.

Sheg

Sheg helps you explore how different simulated readers respond to text. It runs bounded studies with frozen respondent profiles, typed questions, and recorded answers you can inspect and use to shape a follow-up.

A study example

Suppose you are choosing a pull quote for an article. Sheg can ask a varied set of reader profiles which paragraph best represents the article's central idea, then let you select the recorded contexts for a follow-up that presents each chosen paragraph on its own and asks what it communicates. The first study compares candidates; the follow-up helps you inspect why they worked for those simulated readers.

Vary respondent profiles, stimulus text, questions and response options, or what each respondent has already seen. Repeating identical inputs does not add meaningful coverage. Simulated responses can help you explore alternatives, but they do not establish human readership, real-world accuracy, statistical significance, or causal lift.

Install and start

Sheg supports the Codex plugin harness and requires Node.js 24. You do not need TypeScript, npm dependencies, or a local build to use the packaged plugin.

Add the Sheg Git marketplace with codex plugin marketplace add HarleyBartles/sheg, restart Codex, then select Sheg in the Plugins Directory. For a versioned GitHub Release ZIP or local development, follow the installation guide.

Start with a request such as: “I am choosing a pull quote for this article. Help me compare the strongest candidate paragraphs with distinct reader perspectives, then propose a follow-up that shows each selected paragraph in isolation and asks what it communicates.” Sheg helps shape the study and checks its fit before asking you to approve a run. Hosted inference needs your authorization and a call limit.

Learn more

Sheg is licensed under the MIT License.