Metadata-Version: 2.4
Name: odevio
Version: 1.4.0
Summary: Let your AI agent build and publish iOS apps with Odevio - no Mac, no Xcode. Works with any AI agent that supports the Agent Skills standard.
Project-URL: Homepage, https://www.odevio.com
Project-URL: Documentation, https://odevio-cli.readthedocs.io/
Project-URL: Source, https://github.com/Odevio/Odevio-CLI
Author-email: Odevio <hello@odevio.com>
License: Copyright (c) 2023 Odevio
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
        EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
        MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
        IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM,
        DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
        OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE
        OR OTHER DEALINGS IN THE SOFTWARE.
License-File: LICENSE
Keywords: AI agent,App Store,CI/CD,Claude Code,Flutter,code signing,iOS,without a Mac
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.9
Requires-Dist: click==8.0.4
Requires-Dist: paramiko==3.0.0
Requires-Dist: pyjwt==2.4.0
Requires-Dist: qrcode==7.4.2
Requires-Dist: questionary==1.10.0
Requires-Dist: requests==2.27.1
Requires-Dist: rich==11.2.0
Requires-Dist: sseclient-py==1.8.0
Description-Content-Type: text/x-rst

.. image:: https://odevio.com/static/img/logo__odevio.svg
    :align: center
    :height: 200px
    :width: 100%

.. image:: https://img.shields.io/badge/version-1.4.0-blue
    :target: https://github.com/Odevio/Odevio-CLI/

.. image:: https://img.shields.io/github/license/odevio/odevio-cli
    :target: https://github.com/Odevio/Odevio-CLI/blob/master/LICENSE

.. image:: https://img.shields.io/librariesio/release/pypi/odevio
    :target: https://pypi.org/project/odevio/

.. image:: https://img.shields.io/pypi/dm/odevio
    :target: https://pypi.org/project/odevio/

.. image:: https://img.shields.io/uptimerobot/ratio/m792431382-e51d8a06926b56c359afe3b7
    :target: https://stats.uptimerobot.com/QqN9MFXvw3
    :alt: UptimeRobot

.. image:: https://www.codefactor.io/repository/github/odevio/odevio-cli/badge
   :target: https://www.codefactor.io/repository/github/odevio/odevio-cli
   :alt: CodeFactor

======================================================================
Build and publish iOS apps with your AI agent - no Mac, no iOS jargon
======================================================================
Odevio lets an AI agent build and publish your iOS apps for you. It runs the build and signing on
remote Macs, so you need no Mac, no Xcode and no iOS knowledge. Claude Code is the first AI agent
supported.
Thanks for checking it out.

------------
Installation
------------
Odevio is a CLI utility developed in Python. It is easily installed with
pip.

.. code-block::

    pip install odevio

-------------------------
Use it with an AI agent
-------------------------
The way to use Odevio is to let your AI agent drive it. Install the skill once (this sets up Claude Code,
the first AI agent supported):

.. code-block::

    odevio skill install

Using another agent? Add ``--agent``:

.. code-block::

    odevio skill install --agent codex      # or: cursor, gemini
    odevio skill install --agent universal  # .agents/skills, read by several agents
    odevio skill install --agent all        # every supported agent at once

Only Claude Code also gets its commands pre-approved; the others follow their own approval rules. For any
other agent that reads the open Agent Skills standard, ``--to <its skills directory>`` installs it anywhere.

Then, in your Flutter project, just ask your agent to put your app on your iPhone. It writes the code,
Odevio builds and signs it on a real Mac, fixes what breaks, and ships it to TestFlight. See the
`AI agent guide <https://odevio-cli.readthedocs.io/en/latest/ai_assistant/index.html>`_.

----------------------
Use the CLI yourself
----------------------
Prefer to drive Odevio directly? To start using Odevio simply run :code:`odevio` in your console.

Start by creating an account

.. code-block::

    odevio signup

Your Odevio account is now created and you can either start a build machine in configuration mode : to configure XCode or test your app in the iOS simulator.

.. code-block::

    odevio build start --build-type configuration


Or you can build an IPA or release your app by linking your Apple Developer Account to Odevio and creating an app identifier

.. code-block::

    odevio apple add --apple-id APPLE_TEAM_ID --name TEXT --key-id APPLE_KEY_ID --issuer-id APPLE_ISSUER_ID --private-key LOCATION_APPLE_PRIVATE_KEY
    odevio app mk --name MY_APP_NAME --bundle-id COM.COMPANY.APP_NAME

To create the IPA to install on a physical device for testing purposes

.. code-block::

    odevio build start --build-type ad-hoc
    odevio build ipa

To publish directly to the App Store

.. code-block::

    odevio build start --build-type publication

Your build failed ? No worries, you can check the logs with

.. code-block::

    odevio build logs

-------------
Documentation
-------------
All documentation is in the :code:`docs` directory and online at https://odevio-cli.readthedocs.io/.
If you are getting started this is how we recommend you use the docs :

* First read the `installation guide <https://odevio-cli.readthedocs.io/en/latest/installation/index.html>`_.
* Next, the `Tutorial <https://odevio-cli.readthedocs.io/en/latest/ai_assistant/index.html>`_ shows how to use Odevio with your AI agent.
* Finally, the `reference guide <https://odevio-cli.readthedocs.io/en/latest/reference_guide/index.html>`_ covers every option Odevio has to offer.

-----
About
-----
**Our mission is to let anyone build and publish an iOS app through an AI agent, without owning a Mac
or knowing the iOS ecosystem.**

Odevio gives your AI agent the tools to build and ship iOS apps for you.

**What does Odevio do for you ?**

#. It lets an AI agent such as Claude Code drive the whole flow from plain-language requests.
#. It manages iOS specifics - certificates, devices, provisioning profiles, bundle IDs, Xcode configuration.
#. It builds your Flutter app on remote Macs, so you need no Mac of your own.
#. It fixes build failures, then hosts the app or ships it to TestFlight and the App Store.

------------
Contributing
------------
Thank you for considering contributing to Odevio. The main purpose of this repository is to continue evolving Odevio to make Flutter developer's lives easier.

Please report improvements, bugs and issues to Github's issue tracker.
Pull requests linked to open issues are even more appreciated.

Odevio's GitHub issue tracker is not intended to provide help or support.
For that, see the `documentation <https://odevio-cli.readthedocs.io/>`_.

We are also thrilled to receive a variety of other contributions including:

* Documentation updates, enhancements, designs, or bugfixes.
* Spelling or grammar fixes.
* Blogging, speaking about, or creating tutorials about Odevio.

**Giving Odevio a Github star is much appreciated by our team ! Sharing our project with other Flutter developers is too :)**
