# AppX Documentation ## APPX\_Documentation - [Documentation](https://docs.mozark.ai/readme.md) ## Test Infrastructure Documentation - [Test Infrastructure](https://docs.mozark.ai/test-infrastructure-documentation/test-infrastructure.md): Start here to navigate the Testing Portal docs by workflow, platform topic, and support need. - [Overview](https://docs.mozark.ai/test-infrastructure-documentation/getting-started/overview.md): A high-level map of the portal's modules and how they connect. - [Create your first workflow](https://docs.mozark.ai/test-infrastructure-documentation/getting-started/create-your-first-workflow.md): Access the portal, sign in, and select the right working context before your first test. - [Overview](https://docs.mozark.ai/test-infrastructure-documentation/interactive-testing/overview.md): Launch and run live manual test sessions across web, mobile, and TV platforms. - [Overview](https://docs.mozark.ai/test-infrastructure-documentation/automation/overview.md): Connect Playwright and Appium test suites to Mozark's remote execution infrastructure. - [Playwright Hub](https://docs.mozark.ai/test-infrastructure-documentation/automation/playwright-hub.md): Connect Playwright test suites to Mozark's browser grid. - [Appium Hub](https://docs.mozark.ai/test-infrastructure-documentation/automation/appium-hub.md): Connect Appium test suites to Mozark's real device cloud. - [Enterprise Testing](https://docs.mozark.ai/test-infrastructure-documentation/automation/enterprise-testing.md): Advanced enterprise testing features coming soon. - [Overview](https://docs.mozark.ai/test-infrastructure-documentation/file-management/overview.md): Upload, organize, and share app builds, test data, and other testing artifacts. - [Overview](https://docs.mozark.ai/test-infrastructure-documentation/sessions/overview.md): Find, filter, and review interactive and automation sessions. - [Session Details](https://docs.mozark.ai/test-infrastructure-documentation/sessions/session-details.md): Inspect session metadata, video, screenshots, bugs, notes, and output artifacts. - [Session Management](https://docs.mozark.ai/test-infrastructure-documentation/sessions/session-management.md): Find, search, filter, and organize your test sessions. - [UI and Navigation Behavior](https://docs.mozark.ai/test-infrastructure-documentation/ui-and-navigation-behavior.md): Understand themes, notifications, navigation patterns, and shared UI behavior across the portal. - [Permissions and Security](https://docs.mozark.ai/test-infrastructure-documentation/permissions-and-security.md): Understand authentication, access control, data isolation, and token handling across the portal. - [Known Limitations and Edge Cases](https://docs.mozark.ai/test-infrastructure-documentation/known-limitations-and-edge-cases.md): Review current constraints and release-specific behaviors across sessions, files, and shared UI. - [Best Practices](https://docs.mozark.ai/test-infrastructure-documentation/best-practices.md): Follow recommended patterns for naming, tagging, filing bugs, using AI, managing files, and reviewing sessions. - [Troubleshooting & FAQs](https://docs.mozark.ai/test-infrastructure-documentation/troubleshooting-and-faqs.md): Resolve common issues with login, sessions, devices, files, and scheduled tests. ## Test Context Manager Documentation - [Test Context Manager](https://docs.mozark.ai/test-context-manager-documentation/test-context-manager.md): Centralized test management for planning, execution, traceability, and reporting. - [Overview](https://docs.mozark.ai/test-context-manager-documentation/getting-started/overview.md): Start using Test Context Manager with a new account, starter data, and core navigation. - [Your starter workspace](https://docs.mozark.ai/test-context-manager-documentation/getting-started/overview/your-starter-workspace.md): Understand the default organization, app, project, and sample data created for new users. - [Basic navigation](https://docs.mozark.ai/test-context-manager-documentation/getting-started/overview/basic-navigation.md): Find the main areas of Test Context Manager and move between core workflows. - [Sign up and first login](https://docs.mozark.ai/test-context-manager-documentation/getting-started/overview/sign-up-and-first-login.md): Create your account, verify your email, and sign in for the first time. - [Create your first workflow](https://docs.mozark.ai/test-context-manager-documentation/getting-started/create-your-first-workflow.md): Create your first test case, plan, and run in Test Context Manager. - [Overview](https://docs.mozark.ai/test-context-manager-documentation/requirements/overview.md): Learn what the Requirements module does in Test Manager. - [Creating a requirement](https://docs.mozark.ai/test-context-manager-documentation/requirements/creating-a-requirement.md): Create a requirement and save its key details. - [Requirement fields reference](https://docs.mozark.ai/test-context-manager-documentation/requirements/creating-a-requirement/requirement-fields-reference.md): Review the fields available on a requirement. - [Traceability](https://docs.mozark.ai/test-context-manager-documentation/requirements/creating-a-requirement/traceability.md): Link requirements, test cases, and bugs to measure coverage. - [Overview](https://docs.mozark.ai/test-context-manager-documentation/test-cases/overview.md): Learn what test cases are and how to access them in Test Context Manager. - [Creating a test case](https://docs.mozark.ai/test-context-manager-documentation/test-cases/creating-a-test-case.md): Create a test case and add test steps. - [Test case fields reference](https://docs.mozark.ai/test-context-manager-documentation/test-cases/creating-a-test-case/test-case-fields-reference.md): Review the fields available on a test case. - [Importing test cases from CSV](https://docs.mozark.ai/test-context-manager-documentation/test-cases/creating-a-test-case/importing-test-cases-from-csv.md): Import test cases in bulk from a CSV file. - [Organizing with folders](https://docs.mozark.ai/test-context-manager-documentation/test-cases/creating-a-test-case/organizing-with-folders.md): Group test cases into a folder hierarchy. - [Searching and filtering](https://docs.mozark.ai/test-context-manager-documentation/test-cases/creating-a-test-case/searching-and-filtering.md): Search, filter, group, and customize the test case list. - [Viewing and editing a test case](https://docs.mozark.ai/test-context-manager-documentation/test-cases/creating-a-test-case/viewing-and-editing-a-test-case.md): Open a test case, edit fields, and review comments and history. - [Attachments](https://docs.mozark.ai/test-context-manager-documentation/test-cases/creating-a-test-case/viewing-and-editing-a-test-case/attachments.md): Upload and manage file attachments for test cases and other entities. - [Exporting test cases](https://docs.mozark.ai/test-context-manager-documentation/test-cases/creating-a-test-case/exporting-test-cases.md): Export filtered or selected test cases in CSV or JSON format. - [Overview](https://docs.mozark.ai/test-context-manager-documentation/test-plans/overview.md): Learn what test plans are and how to use them in Test Context Manager. - [Creating a test plan](https://docs.mozark.ai/test-context-manager-documentation/test-plans/creating-a-test-plan.md): Create a test plan and link test cases to it. - [Test plan fields reference](https://docs.mozark.ai/test-context-manager-documentation/test-plans/creating-a-test-plan/test-plan-fields-reference.md): Review the fields available on a test plan. - [Viewing a test plan](https://docs.mozark.ai/test-context-manager-documentation/test-plans/creating-a-test-plan/viewing-a-test-plan.md): Open a test plan and review progress, linked cases, runs, and history. - [Test plan workflows](https://docs.mozark.ai/test-context-manager-documentation/test-plans/creating-a-test-plan/test-plan-workflows.md): Understand the core lifecycle from plan creation to execution. - [Overview](https://docs.mozark.ai/test-context-manager-documentation/test-runs/overview.md): Learn what test runs are and what they capture. - [Creating a test run](https://docs.mozark.ai/test-context-manager-documentation/test-runs/creating-a-test-run.md): Create a test run from a plan or as an ad-hoc run. - [Executing a test case](https://docs.mozark.ai/test-context-manager-documentation/test-runs/creating-a-test-run/executing-a-test-case.md): Run a test case step by step and record execution results. - [Adding evidence and comments](https://docs.mozark.ai/test-context-manager-documentation/test-runs/creating-a-test-run/executing-a-test-case/adding-evidence-and-comments.md): Add per-step attachments and comments during execution. - [Linking and creating bugs](https://docs.mozark.ai/test-context-manager-documentation/test-runs/creating-a-test-run/executing-a-test-case/linking-and-creating-bugs.md): Link an existing bug or create a new bug from a failed step. - [Retrying a test case](https://docs.mozark.ai/test-context-manager-documentation/test-runs/creating-a-test-run/executing-a-test-case/retrying-a-test-case.md): Re-run a failed test case without creating a new test run. - [Finishing a test run](https://docs.mozark.ai/test-context-manager-documentation/test-runs/creating-a-test-run/executing-a-test-case/finishing-a-test-run.md): Complete a run and lock its execution record. - [Overview](https://docs.mozark.ai/test-context-manager-documentation/bug-tracking/overview.md): Learn how bug tracking works in Test Manager. - [Creating a bug](https://docs.mozark.ai/test-context-manager-documentation/bug-tracking/creating-a-bug.md): Create a bug from test execution or from the Bugs section. - [Bug fields reference](https://docs.mozark.ai/test-context-manager-documentation/bug-tracking/creating-a-bug/bug-fields-reference.md): Review the fields available on a bug. - [Bug lifecycle](https://docs.mozark.ai/test-context-manager-documentation/bug-tracking/creating-a-bug/bug-lifecycle.md): Understand bug statuses and how they move through resolution. - [JIRA synchronization](https://docs.mozark.ai/test-context-manager-documentation/bug-tracking/creating-a-bug/jira-synchronization.md): Sync bugs between Test Manager and JIRA when integration is configured. - [Overview](https://docs.mozark.ai/test-context-manager-documentation/reports-and-analytics/overview.md): Learn how reporting and analytics work in Test Context Manager. - [Generating a report](https://docs.mozark.ai/test-context-manager-documentation/reports-and-analytics/generating-a-report.md): Create a report, configure its scope, and export it as PDF. - [Scheduled reports](https://docs.mozark.ai/test-context-manager-documentation/reports-and-analytics/generating-a-report/scheduled-reports.md): Schedule reports to generate automatically on a recurring basis. - [Report types](https://docs.mozark.ai/test-context-manager-documentation/reports-and-analytics/generating-a-report/report-types.md): Review the report types available in Test Manager. - [Traceability report](https://docs.mozark.ai/test-context-manager-documentation/reports-and-analytics/generating-a-report/traceability-report.md): View requirement coverage, linked test cases, and related bugs in one matrix. - [For You dashboard](https://docs.mozark.ai/test-context-manager-documentation/reports-and-analytics/generating-a-report/for-you-dashboard.md): Review project-level quality metrics from the For You page. - [Integrations](https://docs.mozark.ai/test-context-manager-documentation/integrations.md): Connect Test Manager with external systems such as JIRA for traceability and bug synchronization. ## Agent Workspace Documentation - [Agent Workspace](https://docs.mozark.ai/agent-workspace-documentation/agent-workspace.md): Use our agents to plan faster, clean up duplicate coverage, and generate test cases without leaving your current workflow. - [Overview](https://docs.mozark.ai/agent-workspace-documentation/getting-started/overview.md): Understand what each TCM Agent does and when to use it. - [Overview](https://docs.mozark.ai/agent-workspace-documentation/author-agent/overview.md): Generate, review, and save AI-created test cases for a feature or flow. - [Overview](https://docs.mozark.ai/agent-workspace-documentation/planner-agent/overview.md): Find relevant existing test cases and turn them into a test plan. - [Planner Agent search tips](https://docs.mozark.ai/agent-workspace-documentation/planner-agent/planner-agent-search-tips.md): Understand query behavior, result limits, and how to get better matches. - [Overview](https://docs.mozark.ai/agent-workspace-documentation/cleaner-agent/overview.md): Find duplicate and near-duplicate test cases, then decide what to keep, merge, or remove. - [Cleaner Agent scan modes](https://docs.mozark.ai/agent-workspace-documentation/cleaner-agent/cleaner-agent-scan-modes.md): Understand scan types, thresholds, and how to read cleanup recommendations. - [Common workflows](https://docs.mozark.ai/agent-workspace-documentation/common-workflows.md): Common ways teams use Author Agent, Cleaner Agent, and Planner Agent together. - [Best practices](https://docs.mozark.ai/agent-workspace-documentation/best-practices.md): Get better results from Author Agent, Cleaner Agent, and Planner Agent. - [FAQ and troubleshooting](https://docs.mozark.ai/agent-workspace-documentation/faq-and-troubleshooting.md): Solve common issues when searching, generating, or cleaning up test cases. ## Administration Control Plane - [Administration Control Plane](https://docs.mozark.ai/administration-control-plane/administration-control-plane.md): Centralized governance for enterprise Mozark environments. - [Dashboard and usage](https://docs.mozark.ai/administration-control-plane/dashboard-and-usage.md): Monitor resource counts, subscription status, and plan consumption across the control plane. - [Organizations](https://docs.mozark.ai/administration-control-plane/organizations.md): Manage business entities, default workspaces, and organization-level resource visibility. - [Applications](https://docs.mozark.ai/administration-control-plane/applications.md): Organize products under test and manage their lifecycle inside an organization. - [Projects](https://docs.mozark.ai/administration-control-plane/projects.md): Create isolated execution workspaces and control collaboration at the project level. - [Infrastructure](https://docs.mozark.ai/administration-control-plane/infrastructure.md): Govern devices, pools, and project mappings for controlled test execution. - [User management and roles](https://docs.mozark.ai/administration-control-plane/user-management-and-roles.md): Invite users, track membership, and enforce role-based access control. - [Integrations and API access](https://docs.mozark.ai/administration-control-plane/integrations-and-api-access.md): Connect Mozark to external systems with API keys, webhooks, and supported integrations. - [Frequently asked questions](https://docs.mozark.ai/administration-control-plane/frequently-asked-questions.md): Customer-facing answers to common questions about the Administration Control Plane. - [Security and governance](https://docs.mozark.ai/administration-control-plane/security-and-governance.md): Apply enterprise controls for authentication, authorization, auditability, and operating model design. ## MCP - [Mozark MCP Docs](https://docs.mozark.ai/mcp/mozark-mcp-docs.md): Use Mozark from any MCP-compatible AI assistant. - [Overview](https://docs.mozark.ai/mcp/mozark-mcp-docs/overview.md): What the Mozark MCP server does. - [Getting started](https://docs.mozark.ai/mcp/mozark-mcp-docs/getting-started.md): Connect Mozark and prepare your first MCP session. - [Quickstart](https://docs.mozark.ai/mcp/mozark-mcp-docs/getting-started/quickstart.md): Connect Mozark and complete your first action. - [Connect your client](https://docs.mozark.ai/mcp/mozark-mcp-docs/getting-started/connect-your-client.md): Configure the Mozark MCP server in your AI client. - [Authentication and context](https://docs.mozark.ai/mcp/mozark-mcp-docs/getting-started/authentication-and-context.md): Sign in securely and select your Mozark workspace. - [Guides](https://docs.mozark.ai/mcp/mozark-mcp-docs/guides.md): Complete common Mozark workflows with your AI assistant. - [Generate test cases](https://docs.mozark.ai/mcp/mozark-mcp-docs/guides/generate-test-cases.md): Create grounded test coverage with the Author Agent. - [Build your knowledge base](https://docs.mozark.ai/mcp/mozark-mcp-docs/guides/build-your-knowledge-base.md): Ground AI-generated tests in product screenshots and requirements. - [Manage test cases, plans, and runs](https://docs.mozark.ai/mcp/mozark-mcp-docs/guides/manage-test-cases-plans-and-runs.md): Manage TCM work through your AI assistant. - [Run tests on a real device](https://docs.mozark.ai/mcp/mozark-mcp-docs/guides/run-tests-on-a-real-device.md): Execute test cases on Mozark cloud devices with Optics. - [Automate devices with Appium](https://docs.mozark.ai/mcp/mozark-mcp-docs/guides/automate-devices-with-appium.md): Drive Mozark cloud devices for exploratory testing and automation. - [Find duplicate test cases](https://docs.mozark.ai/mcp/mozark-mcp-docs/guides/find-duplicate-test-cases.md): Identify and safely clean near-duplicate test cases. - [Reference](https://docs.mozark.ai/mcp/mozark-mcp-docs/reference.md): Explore available tools, prompts, and required workflows. - [Workflow rules](https://docs.mozark.ai/mcp/mozark-mcp-docs/reference/workflow-rules.md): Required procedures that keep Mozark workflows reliable. - [Example prompts](https://docs.mozark.ai/mcp/mozark-mcp-docs/reference/example-prompts.md): Ready-to-adapt prompts for common Mozark tasks. - [Tools by category](https://docs.mozark.ai/mcp/mozark-mcp-docs/reference/tools-by-category.md): Browse Mozark MCP tools by capability. - [Security and help](https://docs.mozark.ai/mcp/mozark-mcp-docs/security-and-help.md): Understand data handling and resolve common issues. - [Troubleshooting](https://docs.mozark.ai/mcp/mozark-mcp-docs/security-and-help/troubleshooting.md): Resolve connection, context, device, and test-run errors. - [FAQ](https://docs.mozark.ai/mcp/mozark-mcp-docs/security-and-help/faq.md): Answers to common questions about Mozark MCP. - [Legacy summary](https://docs.mozark.ai/mcp/mozark-mcp-docs/legacy-summary.md) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on a page URL with the `ask` query parameter: ``` GET https://docs.mozark.ai/readme.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.