{"id":49491998,"url":"https://github.com/abengkris/scripthis","last_synced_at":"2026-05-01T07:01:38.647Z","repository":{"id":354429926,"uuid":"1223410651","full_name":"abengkris/scripthis","owner":"abengkris","description":"Gemini CLI extension for screenwriters. Includes Save the Cat \u0026 Hero's Journey analysis, character bibles, Git draft vault, and PDF export.","archived":false,"fork":false,"pushed_at":"2026-04-28T15:09:49.000Z","size":22,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-28T15:29:43.957Z","etag":null,"topics":["ai-assistant","ai-tools","cli-tools","fountain","gemini-cli-extension","screenwriting","scriptwriter","scriptwriting","storytelling"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/abengkris.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-28T09:48:06.000Z","updated_at":"2026-04-28T15:09:57.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/abengkris/scripthis","commit_stats":null,"previous_names":["abengkris/scripthis"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/abengkris/scripthis","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abengkris%2Fscripthis","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abengkris%2Fscripthis/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abengkris%2Fscripthis/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abengkris%2Fscripthis/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/abengkris","download_url":"https://codeload.github.com/abengkris/scripthis/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/abengkris%2Fscripthis/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32487739,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-30T13:12:12.517Z","status":"online","status_checked_at":"2026-05-01T02:00:05.856Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-assistant","ai-tools","cli-tools","fountain","gemini-cli-extension","screenwriting","scriptwriter","scriptwriting","storytelling"],"created_at":"2026-05-01T07:01:37.942Z","updated_at":"2026-05-01T07:01:38.641Z","avatar_url":"https://github.com/abengkris.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎬 ScripThis: AI-Powered Professional Screenwriting Suite\n\n**ScripThis** is a high-performance Gemini CLI extension designed for professional screenwriters and showrunners. It transforms an LLM into a \"Digital Showrunner\" that manages project metadata, character bibles, world rules, and industry-standard formatting.\n\nUnlike standard AI writing tools, ScripThis uses **Grounding and State-Awareness** to ensure your script stays consistent in voice, theme, and pacing from the first logline to the final polish.\n\n---\n\n## 🚀 Key Features\n\n*   **The 6-P Workflow:** A milestone-driven system (Pitch, World, People, Plan, Pages, Polish) that keeps your project moving through the professional development lifecycle.\n*   **Genre-Specific Templates:** Automatically populates your outline and world rules with professional structures tailored for Horror, Sci-Fi, Sitcom, Drama, and Action.\n*   **Fountain Native:** Generates and reads strictly formatted `.fountain` files, compatible with industry software like Final Draft, Fade In, and Highland 2.\n*   **Character Grounding:** Maintains deep character bibles that the AI references before every line of dialogue to prevent \"voice drift.\"\n*   **Studio-Grade Coverage:** A `/review` command that interactively analyzes your script. Choose from General Coverage, or advanced frameworks like the \"Hero's Journey\", \"Save the Cat\", \"Story Circle\", and \"8-Sequence Approach\".\n*   **Interactive Wizards:** Uses the `ask_user` tool for a sleek setup, character creation, review selection, and moodboard generation.\n*   **Moodboard Integration:** Automatically reads your bibles and world rules to generate highly detailed prompts for image generators like Midjourney.\n*   **Advanced Story Frameworks (Skills):** Access a virtual Writer's Room with skills built-in for: Fountain Syntax, Three-Act Structure, Save the Cat, Hero's Journey, Dan Harmon's Story Circle, 8-Sequence Approach, Enneagram, Pixar's 22 Rules, and Dialogue Doctor.\n\n---\n\n## 🛠 Commands\n\n| Command | Action |\n| :--- | :--- |\n| `/scripthis:setup` | Launches the Project Wizard to define Title, Genre, and Format. |\n| `/scripthis:workflow` | Summarizes project status and identifies the next professional milestone. |\n| `/scripthis:character` | Launches the Character Wizard to build a grounded cast bible. |\n| `/scripthis:write` | Drafts the next scene or sequence based on your approved outline. |\n| `/scripthis:review` | Provides a \"Studio Coverage\" report with structural and dialogue analysis. |\n| `/scripthis:scenes` | Displays an instant summary of all scene headings (Sluglines) in your script. |\n| `/scripthis:export` | Exports the current `.fountain` script to a professional PDF file. |\n| `/scripthis:research`| Performs live web research and fact-checking for your script. |\n| `/scripthis:save_draft`| Secures your script's current state into a Git-based \"Draft Vault\" for safe rewriting. |\n| `/scripthis:restore`   | Restores your script to a previous version from the Studio Vault (Time Machine). |\n| `/scripthis:logline`   | Refines and validates your story's logline against professional pillars. |\n| `/scripthis:dialogue_doctor` | Polishes scene dialogue to add subtext and remove \"on-the-nose\" lines. |\n| `/scripthis:moodboard` | Generates detailed image prompts to visualize characters and locations. |\n| `/scripthis:help` | Displays the Studio Manual and Pro-Tips for best results. |\n\n---\n\n## 📂 Project Structure\n\nScripThis organizes your project into a professional studio hierarchy:\n\n```text\nproject_root/\n├── characters/        # Markdown files for every character's voice and history.\n├── reference/         # Research and world-building notes.\n├── drafts/            # Older versions of your script.\n├── project.json       # Metadata (Genre, Format, Logline).\n├── workflow.md        # The 6-P milestone tracker.\n├── outline.md         # Your scene-by-scene beat sheet.\n├── world_rules.md     # The \"Project Bible\" for setting consistency.\n└── [title].fountain   # Your main industry-standard script file.\n```\n\n---\n\n## 💻 Installation \u0026 Setup\n\n### 1. Requirements\n*   **Gemini CLI v0.5.0 or higher** (Required for `activate_skill` functionality).\n*   *(Optional)* **Node.js/npm** if you want to use the `/scripthis:export` command (it uses `npx afterwriting` to generate PDFs).\n\n*Note: ScripThis utilizes advanced AI skills. If a skill is not found, the system will proceed with standard prompt-based intelligence. Please ensure your environment is updated to support extension-level skills.*\n\n### 2. Local Installation\nClone this repository to your local machine and run the following in the project root to link the extension to your Gemini CLI:\n\n```bash\ngemini extension install .\n```\n\n---\n\n## 🖋 Philosophy: \"The Showrunner Method\"\nScripThis does not try to write your script in one go. It uses the **Incremental Drafting** method. By writing 3-5 pages at a time and constantly cross-referencing your `outline.md` and `character` files, it ensures that the AI's output is as sharp on page 90 as it was on page 1.\n\n---\n*Created for writers who want the power of AI with the control of a professional studio.*\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabengkris%2Fscripthis","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fabengkris%2Fscripthis","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabengkris%2Fscripthis/lists"}