{
  "product": "Deputy Shell",
  "releaseChannel": "closed-alpha",
  "currentVersion": "0.13.0-alpha.1",
  "lastUpdated": "2026-07-31",
  "articles": [
    {
      "id": "what-is-deputy-shell",
      "title": "What is Deputy Shell?",
      "url": "https://deputyshell.com/docs/what-is-deputy-shell/",
      "summary": "Deputy Shell is a native Android terminal and project workspace for coding-agent workflows. What it is, what it is not, and how it differs from a cloud IDE or an OpenAI subscription.",
      "category": "Start Here",
      "featureStatus": "Available",
      "appliesTo": "0.13.0-alpha.1 (pre-alpha)",
      "lastVerified": "2026-07-31",
      "tags": [
        "overview",
        "android terminal",
        "coding workspace"
      ]
    },
    {
      "id": "getting-started",
      "title": "Getting Started",
      "url": "https://deputyshell.com/docs/getting-started/",
      "summary": "The first-use sequence for Deputy Shell: initial runtime setup, creating a project workspace, starting a terminal or Codex session, and basic safety guidance.",
      "category": "Start Here",
      "featureStatus": "Available",
      "appliesTo": "0.13.0-alpha.1 (pre-alpha)",
      "lastVerified": "2026-07-31",
      "tags": [
        "onboarding",
        "first run",
        "setup"
      ]
    },
    {
      "id": "requirements",
      "title": "Requirements",
      "url": "https://deputyshell.com/docs/requirements/",
      "summary": "Deputy Shell's verified Android version, CPU architecture, storage and network requirements, and what has and hasn't been validated on real devices.",
      "category": "Start Here",
      "featureStatus": "Available with limitations",
      "appliesTo": "0.13.0-alpha.1 (pre-alpha)",
      "lastVerified": "2026-07-31",
      "tags": [
        "requirements",
        "android version",
        "arm64",
        "device compatibility"
      ]
    },
    {
      "id": "runtime-setup",
      "title": "Runtime Setup",
      "url": "https://deputyshell.com/docs/runtime-setup/",
      "summary": "Why Deputy Shell downloads a separate development runtime on first launch, what each runtime module contains, and how setup recovers from an interruption.",
      "category": "Start Here",
      "featureStatus": "Available with limitations",
      "appliesTo": "0.13.0-alpha.1 (pre-alpha)",
      "lastVerified": "2026-07-31",
      "tags": [
        "runtime",
        "play feature delivery",
        "first run",
        "setup"
      ]
    },
    {
      "id": "projects-and-workspaces",
      "title": "Projects and Workspaces",
      "url": "https://deputyshell.com/docs/projects-and-workspaces/",
      "summary": "What a project workspace is in Deputy Shell, how projects map to folders, and how the Default Workspace behaves.",
      "category": "Projects and Workspaces",
      "featureStatus": "Available",
      "appliesTo": "0.13.0-alpha.1 (pre-alpha)",
      "lastVerified": "2026-07-31",
      "tags": [
        "projects",
        "workspaces",
        "default workspace",
        "agents.md"
      ]
    },
    {
      "id": "managing-projects",
      "title": "Managing Projects",
      "url": "https://deputyshell.com/docs/managing-projects/",
      "summary": "How to create, rename, and delete projects in Deputy Shell, including what an optional workspace-folder rename does and what project deletion does and doesn't remove.",
      "category": "Projects and Workspaces",
      "featureStatus": "Available",
      "appliesTo": "0.13.0-alpha.1 (pre-alpha)",
      "lastVerified": "2026-07-31",
      "tags": [
        "projects",
        "rename",
        "delete"
      ]
    },
    {
      "id": "importing-projects",
      "title": "Importing Projects",
      "url": "https://deputyshell.com/docs/importing-projects/",
      "summary": "How to import a ZIP archive or single file into a Deputy Shell project workspace, how conflicts are handled, and how interrupted imports recover safely.",
      "category": "Files, Imports and Exports",
      "featureStatus": "Available with limitations",
      "appliesTo": "0.13.0-alpha.1 (pre-alpha)",
      "lastVerified": "2026-07-31",
      "tags": [
        "import",
        "zip",
        "document picker"
      ]
    },
    {
      "id": "exporting-workspaces",
      "title": "Exporting Workspaces",
      "url": "https://deputyshell.com/docs/exporting-workspaces/",
      "summary": "How Deputy Shell exports a project workspace as a ZIP file, which paths are excluded to reduce accidental disclosure, and why you should still review an export before sharing it.",
      "category": "Files, Imports and Exports",
      "featureStatus": "Available with limitations",
      "appliesTo": "0.13.0-alpha.1 (pre-alpha)",
      "lastVerified": "2026-07-31",
      "tags": [
        "export",
        "zip",
        "workspace"
      ]
    },
    {
      "id": "export-recovery",
      "title": "Interrupted Export Recovery",
      "url": "https://deputyshell.com/docs/export-recovery/",
      "summary": "What happens when a Deputy Shell workspace export is interrupted, and how to finish, retry, or discard it using the 'Finish workspace export' dialog.",
      "category": "Files, Imports and Exports",
      "featureStatus": "Available with limitations",
      "appliesTo": "0.13.0-alpha.1 (pre-alpha)",
      "lastVerified": "2026-07-31",
      "tags": [
        "export",
        "recovery",
        "interrupted"
      ]
    },
    {
      "id": "sessions",
      "title": "Sessions",
      "url": "https://deputyshell.com/docs/sessions/",
      "summary": "How Deputy Shell's terminal sessions work: independent processes, session states, and what retained terminal context preserves across restarts.",
      "category": "Sessions and Terminal",
      "featureStatus": "Available",
      "appliesTo": "0.13.0-alpha.1 (pre-alpha)",
      "lastVerified": "2026-07-31",
      "tags": [
        "sessions",
        "terminal",
        "state"
      ]
    },
    {
      "id": "managing-sessions",
      "title": "Managing Sessions",
      "url": "https://deputyshell.com/docs/managing-sessions/",
      "summary": "How to rename, pin, stop, and delete Deputy Shell terminal sessions, use Stop All, and the difference between stopping and deleting a session.",
      "category": "Sessions and Terminal",
      "featureStatus": "Available",
      "appliesTo": "0.13.0-alpha.1 (pre-alpha)",
      "lastVerified": "2026-07-31",
      "tags": [
        "sessions",
        "stop",
        "delete",
        "pin"
      ]
    },
    {
      "id": "moving-sessions",
      "title": "Moving Sessions Between Projects",
      "url": "https://deputyshell.com/docs/moving-sessions/",
      "summary": "How moving a Deputy Shell session to a different project works, and why the terminal's actual working directory doesn't automatically follow the move.",
      "category": "Sessions and Terminal",
      "featureStatus": "Available",
      "appliesTo": "0.13.0-alpha.1 (pre-alpha)",
      "lastVerified": "2026-07-31",
      "tags": [
        "sessions",
        "move",
        "projects"
      ]
    },
    {
      "id": "workspace-mismatch-warning",
      "title": "Workspace Mismatch Warning",
      "url": "https://deputyshell.com/docs/workspace-mismatch-warning/",
      "summary": "What Deputy Shell's 'Running outside project workspace' warning means, why it appears after moving a session, and how to clear it.",
      "category": "Sessions and Terminal",
      "featureStatus": "Available",
      "appliesTo": "0.13.0-alpha.1 (pre-alpha)",
      "lastVerified": "2026-07-31",
      "tags": [
        "warning",
        "workspace",
        "cwd",
        "moved session"
      ]
    },
    {
      "id": "background-sessions",
      "title": "Background Sessions and Notifications",
      "url": "https://deputyshell.com/docs/background-sessions/",
      "summary": "How Deputy Shell keeps terminal sessions running in the background, the notification it shows, and how Android's background restrictions can still affect it.",
      "category": "Sessions and Terminal",
      "featureStatus": "Available with limitations",
      "appliesTo": "0.13.0-alpha.1 (pre-alpha)",
      "lastVerified": "2026-07-31",
      "tags": [
        "background",
        "notification",
        "foreground service"
      ]
    },
    {
      "id": "terminal-controls",
      "title": "Terminal Controls",
      "url": "https://deputyshell.com/docs/terminal-controls/",
      "summary": "Deputy Shell's terminal accessory key row and touch controls for using a full terminal on an Android touchscreen.",
      "category": "Sessions and Terminal",
      "featureStatus": "Available",
      "appliesTo": "0.13.0-alpha.1 (pre-alpha)",
      "lastVerified": "2026-07-31",
      "tags": [
        "terminal",
        "keys",
        "touch controls"
      ]
    },
    {
      "id": "terminal-search-copy-scrollback",
      "title": "Terminal Search, Copy, and Scrollback",
      "url": "https://deputyshell.com/docs/terminal-search-copy-scrollback/",
      "summary": "How to search terminal output, select and copy text, and scroll in Deputy Shell, plus current limitations in its terminal emulation.",
      "category": "Sessions and Terminal",
      "featureStatus": "Available with limitations",
      "appliesTo": "0.13.0-alpha.1 (pre-alpha)",
      "lastVerified": "2026-07-31",
      "tags": [
        "search",
        "copy",
        "selection",
        "scrollback",
        "ansi"
      ]
    },
    {
      "id": "codex-on-android",
      "title": "Codex on Android",
      "url": "https://deputyshell.com/docs/codex-on-android/",
      "summary": "How Deputy Shell integrates OpenAI's Codex CLI on Android: what's bundled, what's optional, account requirements, network requirements, and current limitations.",
      "category": "Codex and Coding Agents",
      "featureStatus": "Available with limitations",
      "appliesTo": "0.13.0-alpha.1 (pre-alpha)",
      "lastVerified": "2026-07-31",
      "tags": [
        "codex",
        "openai",
        "coding agent",
        "android"
      ]
    },
    {
      "id": "codex-sign-in",
      "title": "Codex Sign-In",
      "url": "https://deputyshell.com/docs/codex-sign-in/",
      "summary": "How to sign in to Codex in Deputy Shell: the guided ChatGPT device-authorization flow, and manual API-key login through the bundled Codex CLI for advanced users.",
      "category": "Codex and Coding Agents",
      "featureStatus": "Available with limitations",
      "appliesTo": "0.13.0-alpha.1 (pre-alpha)",
      "lastVerified": "2026-07-31",
      "tags": [
        "codex",
        "sign in",
        "authentication",
        "chatgpt",
        "api key"
      ]
    },
    {
      "id": "codex-approvals",
      "title": "Codex and Command Approvals",
      "url": "https://deputyshell.com/docs/codex-approvals/",
      "summary": "How Deputy Shell's approval prompts work for risky commands and agent actions, what to review before approving, and why you remain responsible for what you approve.",
      "category": "Codex and Coding Agents",
      "featureStatus": "Available",
      "appliesTo": "0.13.0-alpha.1 (pre-alpha)",
      "lastVerified": "2026-07-31",
      "tags": [
        "approvals",
        "safety",
        "guardrails"
      ]
    },
    {
      "id": "included-development-tools",
      "title": "Included Development Tools",
      "url": "https://deputyshell.com/docs/included-development-tools/",
      "summary": "The exact development tools and versions bundled with Deputy Shell's Android runtime, what's planned for future tool packs, and what isn't included.",
      "category": "Development Tools",
      "featureStatus": "Mixed — see status table below",
      "appliesTo": "0.13.0-alpha.1 (pre-alpha)",
      "lastVerified": "2026-07-31",
      "tags": [
        "tools",
        "git",
        "python",
        "node",
        "ripgrep",
        "curl",
        "ssh"
      ]
    },
    {
      "id": "git-python-node-on-android",
      "title": "Git, Python, Node.js, and More on Android",
      "url": "https://deputyshell.com/docs/git-python-node-on-android/",
      "summary": "How Deputy Shell brings Git, Python and pip, Node.js and npm, SSH, curl, and ripgrep together into one Android development runtime, and what that's good for.",
      "category": "Development Tools",
      "featureStatus": "Available",
      "appliesTo": "0.13.0-alpha.1 (pre-alpha)",
      "lastVerified": "2026-07-31",
      "tags": [
        "git",
        "python",
        "pip",
        "node",
        "npm",
        "ssh",
        "curl",
        "ripgrep",
        "android"
      ]
    },
    {
      "id": "local-storage",
      "title": "Local Storage and Data",
      "url": "https://deputyshell.com/docs/local-storage/",
      "summary": "What Deputy Shell stores locally on your Android device, what's excluded from backup, and where exported files end up.",
      "category": "Privacy and Diagnostics",
      "featureStatus": "Available",
      "appliesTo": "0.13.0-alpha.1 (pre-alpha)",
      "lastVerified": "2026-07-31",
      "tags": [
        "storage",
        "local data",
        "backup"
      ]
    },
    {
      "id": "privacy-and-telemetry",
      "title": "Privacy and Telemetry",
      "url": "https://deputyshell.com/docs/privacy-and-telemetry/",
      "summary": "Deputy Shell's optional crash reporting and usage statistics: off by default, controlled independently, and how they relate to local data and Codex/OpenAI processing.",
      "category": "Privacy and Diagnostics",
      "featureStatus": "Available",
      "appliesTo": "0.13.0-alpha.1 (pre-alpha)",
      "lastVerified": "2026-07-31",
      "tags": [
        "privacy",
        "telemetry",
        "crash reporting",
        "analytics"
      ]
    },
    {
      "id": "diagnostics",
      "title": "Diagnostics Export",
      "url": "https://deputyshell.com/docs/diagnostics/",
      "summary": "How Deputy Shell's manual, metadata-only diagnostics export works: what it includes, what it deliberately excludes, and how to share it with support.",
      "category": "Privacy and Diagnostics",
      "featureStatus": "Available",
      "appliesTo": "0.13.0-alpha.1 (pre-alpha)",
      "lastVerified": "2026-07-31",
      "tags": [
        "diagnostics",
        "support",
        "export"
      ]
    },
    {
      "id": "updates",
      "title": "Checking for Updates",
      "url": "https://deputyshell.com/docs/updates/",
      "summary": "How Deputy Shell checks for updates through Google Play, what happens offline or on a sideloaded install, and what's preserved during an update.",
      "category": "Updates and Compatibility",
      "featureStatus": "Available with limitations",
      "appliesTo": "0.13.0-alpha.1 (pre-alpha)",
      "lastVerified": "2026-07-31",
      "tags": [
        "updates",
        "google play"
      ]
    },
    {
      "id": "troubleshooting-runtime-setup",
      "title": "Troubleshooting Runtime Setup",
      "url": "https://deputyshell.com/docs/troubleshooting-runtime-setup/",
      "summary": "What to do if Deputy Shell's runtime setup gets stuck, fails, or reports your device as unsupported.",
      "category": "Troubleshooting",
      "featureStatus": "Reference",
      "appliesTo": "0.13.0-alpha.1 (pre-alpha)",
      "lastVerified": "2026-07-31",
      "tags": [
        "troubleshooting",
        "runtime",
        "setup"
      ]
    },
    {
      "id": "troubleshooting-codex-sign-in",
      "title": "Troubleshooting Codex Sign-In",
      "url": "https://deputyshell.com/docs/troubleshooting-codex-sign-in/",
      "summary": "What to do if the Codex sign-in link won't open, or Deputy Shell doesn't recognize that you've completed sign-in.",
      "category": "Troubleshooting",
      "featureStatus": "Reference",
      "appliesTo": "0.13.0-alpha.1 (pre-alpha)",
      "lastVerified": "2026-07-31",
      "tags": [
        "troubleshooting",
        "codex",
        "sign in"
      ]
    },
    {
      "id": "troubleshooting-sessions",
      "title": "Troubleshooting Sessions and Background Activity",
      "url": "https://deputyshell.com/docs/troubleshooting-sessions/",
      "summary": "What to do if a Deputy Shell session shows 'needs resume', a background session stops unexpectedly, or the background notification is missing.",
      "category": "Troubleshooting",
      "featureStatus": "Reference",
      "appliesTo": "0.13.0-alpha.1 (pre-alpha)",
      "lastVerified": "2026-07-31",
      "tags": [
        "troubleshooting",
        "sessions",
        "background"
      ]
    },
    {
      "id": "known-limitations",
      "title": "Known Limitations",
      "url": "https://deputyshell.com/docs/known-limitations/",
      "summary": "Deputy Shell's current restrictions: application limitations, Android platform limitations, device-validation boundaries, and third-party service dependencies in the current release.",
      "category": "Limitations and Compatibility",
      "featureStatus": "Mixed — see status table below",
      "appliesTo": "0.13.0-alpha.1 (pre-alpha)",
      "lastVerified": "2026-07-31",
      "tags": [
        "limitations",
        "compatibility",
        "known issues"
      ]
    },
    {
      "id": "can-deputy-shell-build-apks",
      "title": "Can Deputy Shell Build Android APKs?",
      "url": "https://deputyshell.com/docs/can-deputy-shell-build-apks/",
      "summary": "Direct answer: Deputy Shell does not currently build, sign, or install Android APKs. An optional Android development pack and on-device debug builds are planned; signing and release workflows are a longer-term direction.",
      "category": "Limitations and Compatibility",
      "featureStatus": "Planned",
      "appliesTo": "0.13.0-alpha.1 (pre-alpha)",
      "lastVerified": "2026-07-31",
      "tags": [
        "apk",
        "android build",
        "roadmap"
      ]
    }
  ]
}