• Inizia
IOS REFERENCE

Jules — your AI marine officer

Jules is AnchorQueen's AI marine officer. Ask a question and a veteran

crew member answers — by text or by voice.

Jules — screenshot pending

The chat

A simple two-column conversation. Your messages on one side, Jules's

replies streaming back on the other, with avatars and timestamps.

  • Type your question in the bottom input bar and tap send.
  • Hold the microphone to record a question by voice. Release to send.
  • Replies stream in as Jules writes them.
  • A row of officer pills at the top lets you pick which officer you are

    talking to. Each has their own background and area of expertise — a

    meteorologist, a navigator, a passage planner. Tap a different officer to

    switch context for the next question.

    Beside Jules's avatar in the header sits a short status line that

    reflects her current mood — calm, working, or a weather alert such as a

    storm warning. It shows on one line and may end in an ellipsis when long;

    tap it to expand the full message, and tap again to collapse.

    Chat history

    Jules keeps every conversation as a separate thread — just like ChatGPT,

    Gemini, or Claude. Tap the history button (the clock-with-arrow icon)

    at the top-left of the chat to slide open the chat-history drawer. It is

    separate from the app's Left Menu — opening the history drawer closes the

    Left Menu, and vice versa, so the two never overlap.

  • Conversations are grouped by recency — Today, Yesterday,
  • Previous 7 Days, and Older — newest at the top.

  • Each row shows the chat's title (auto-named from your first message)
  • and a one-line preview of the latest reply. The active chat is

    highlighted.

  • Tap a row to switch to that conversation. Jules also remembers
  • which officer you were talking to in it.

  • Tap ✎ New Chat (top-right of the drawer) to start a fresh thread —
  • your other conversations are kept, not wiped.

  • Long-press a row (or tap its button) to Rename or
  • Delete it.

    When you reopen the Jules tab, you land back on your most recent

    conversation. If you are signed in, your chat history syncs across your

    devices automatically.

  • --
  • Technical & Streaming Architecture

    Jules is powered by a sophisticated multi-agent orchestration framework (CrewAI) integrated natively into our high-performance client engines.

    CrewAI Multi-Agent Hierarchy

    When you ask Jules a question, an Inference Router automatically evaluates your query and assigns it to the most capable officer persona:

    * Meteorologist: Specialist in micro-weather forecasting, tide metrics, and wave analytics.

    * Navigator: Focuses on spatial calculations, zone detection, and coastal seamarks.

    Passage Planner: Connects with the A-APF routing engine to optimize passages.

    ℹ️
    NOTE
    Backend operations execute in Firebase Cloud Functions (Gen 1 only), utilizing the Gemini 2.5 Flash model for ultra-low latency server-sent event (SSE) processing.

    Server-Sent Events & Chip Streaming Protocol

    Tokens are streamed to the iOS/Android client in real-time. Suggestion chips are injected dynamically at the end of the streaming session using a specialized separator protocol:

    Stream: "I recommend dropping anchor on the east side of the bay where the holding is solid."
    

    Marker: "---CHIPS---[{"text":"Show on map","action":"zoom_in"},{"text":"Check weather","action":"meteo"}]---ENDCHIPS---"

    To prevent raw JSON markers from showing on screen, the client uses a high-performance two-layer SSEStreamClient parser:

  • Transport Layer: Standardizes event packets and handles connection retries.
  • Boundary Parser: Processes incoming byte buffers, looking for the ---CHIPS--- marker. It stops drawing text immediately upon detection, buffering the remaining bytes splitting-chunk-safe via an internal _safeEmitLength state machine, and decodes the suggestion chips in the background to render them instantly above the input field.
  • Inference Routing & Engine Fallbacks

    The client-side InferenceRouter dynamically routes requests based on connection capabilities:

    * On-Device Inference: Uses MLXEngineAdapter and AppleFoundationEngine (via Swift MLX on compatible Apple Silicon chips) to answer basic navigation and offline dictionary terms without a network connection.

    * Cloud Fallback: Automatically switches to the CloudGeminiEngine when complex weather or regional queries are asked, presenting a temporary Engine fallback banner.

    Guidance & Best Practices: How to Interact with Jules

    Jules is designed to be an active co-captain rather than a passive chatbot. Follow these best practices to get the most out of your conversation.

    1. Give Jules a Long-Term Memory

    Before planning a voyage, make sure your profile is updated under the Captain tab (with your boat name, draft, beam, air draft, and cruising speed). Jules accesses these parameters in every conversation:

    Draft Checks: Asking "Is it deep enough in Setur Kalamış Marina?"* automatically resolves Turkish chart contours and compares them with your boat's draft.

    Bridge Clearances: Asking "Can I pass under the channel bridge?"* triggers an immediate verification against your air draft.

    2. Using Hands-Free Voice Commands

    When sailing or helm-bound, typing is impractical. Jules supports high-fidelity local voice-to-text:

    * Recording: Hold down the Microphone icon in the input bar. A wave-pulse indicator appears, confirming active recording.

    Speaking: Speak naturally (e.g., "What is the swell forecast for the anchorage tonight?"*).

    * Sending: Release the microphone button. The audio is immediately transcribed and processed.

    3. Interactive Suggestion Chips

    At the end of a query, Jules often streams in action chips above the chat bar:

    * Map Control: If Jules describes a point of interest (e.g. a marina or danger reef), tap the Show on map chip. The chat drawer will slide closed, and the map camera will automatically zoom and fly to that exact coordinate.

    * Context Switch: Tapping chips like Check weather automatically opens the Meteo tab, preserving your current coordinate context.

    4. Selecting Your Officer Persona

    Tap the pills at the top of the chat to target your query:

    * Navigator: Use when asking about seamarks, maritime zones, territorial limits, or coordinate lookups.

    Passage Planner: Use to request A-APF routes between marinas.

    * Meteorologist: Use for micro-climate analysis, wave period trends, and storm track forecasting.

    The three-dot button on the right opens a menu grouped into two sections:

    Conversation

  • New Chat — start a fresh conversation (past threads are kept in the
  • history drawer, see [Chat history](#history)).

  • Chat History — open the chat-history drawer of past conversations.
  • Refresh Crew — pull the latest officer line-up.
  • Library

  • Recent Briefings — Jules's scheduled briefings (daily / passage).
  • Saved Reports — answers you saved for offline reference.
  • Local Engine — settings for on-device inference (where available).
  • A small badge on Saved Reports shows how many briefings are unread.

    What Jules can do for you

    Jules doesn't just answer questions — she acts on the chart for you.

    Talk to her in plain language; you never need to read out coordinates.

    When you say "here" or "near me" she uses your live GPS position, and

    if there's no fix she uses the centre of the chart you're looking at.

    The sections below show what to ask. Everything here works in everyday

    language — these are just examples.

    Weather & forecasts

    Jules pulls live marine weather and multi-day forecasts for your

    position or anywhere you name.

    > "What's the weather right now?"

    > "Give me the 24-hour forecast here."

    > "What's the 3-day outlook for Mykonos?"

    "Show me the week ahead — is there a good window to cross?"

    She reports wind and gusts, waves, pressure, and conditions, and for

    multi-day questions summarises each day's peak wind, wave height, and

    rain chance.

    Routes & navigation

    Jules plans depth-aware routes that keep you in safe water, saves

    them with a "Jules" badge, and can extend them.

    > "Plan a route from here to Mykonos."

    > "Take me to Delos, then on to Mykonos."

    > "Add a waypoint at the headland to that route."

    "List my saved routes."

    Routes she plans appear in your Saved Routes alongside your own, clearly

    marked so you can review, follow, or delete them.

    Anchoring

    > "Is this a good place to anchor?"

    > "What's the seabed like here?"

    > "How deep is it where I'm pointing?"

    "How crowded will this bay be in a few hours?"

    Jules reads the seabed type and gives a holding score, checks charted

    depth, and predicts anchorage crowding.

    Places, harbours & ports of entry

    > "What's this place called?"

    > "Find marinas near me."

    > "Where can I clear customs nearby?"

    "Any lighthouses or buoys around here?"

    She names the bay, island, or town you're looking at, lists nearby

    harbours and marinas with their facilities, shelter and approach data,

    finds customs and immigration offices (ports of entry), and locates

    charted seamarks — buoys, beacons, and lighthouses.

    When you ask Jules to find a named place ("Take me to Setur Kalamış

    Marina"), she searches exactly the same sources your own chart search

    does — online places, the worldwide marina database, charted features,

    and your saved marks — so she finds marinas and landmarks a plain map

    lookup would miss. Each place Jules looks up is added to your Recent

    searches in the chart search panel, tagged with her ✦ badge so you can

    tell her lookups apart from your own (and filter to just hers).

    Where am I?

    > "Whose waters am I in?"

    "Am I inside territorial waters here?"

    Jules tells you the maritime jurisdiction — the territorial sea, EEZ,

    and sovereign state — at your position or any point on the chart.

    Live traffic & your chart

    > "Any boats anchored near me?"

    > "What's the live traffic around me?"

    > "Show me Mykonos harbour." (Jules moves the chart for you)

    > "Zoom in."

    "Look at my chart and tell me what you see."

    Jules reads nearby vessels (AIS) and other anchored boats, can pan and

    zoom the chart to show you a place, and can even look at the chart

    you're viewing to answer questions about what's on screen.

    Drop marks

    > "Drop a mark here called 'Lunch stop'."

    "Mark this as a good anchorage."

    Marks Jules drops are saved on the chart with your notes, tagged so you

    always know which were hers.

    Talk or type

    Type in the input bar, or hold the microphone and speak — release to

    send. Jules replies in your language, and her replies stream in as she

    writes them.

    Jules remembers you

    Jules carries context across sessions and devices. Tell her your boat's

    name, draft, and home waters once and she'll remember — so "is it deep

    enough for me here?" already knows your draft. She also adapts to you:

    she replies in your language and matches the persona to your profile.

    Free, PRO & MAX

    Jules is included with your captain account and free to use every day.

    Free captains get a generous daily allowance of Jules conversations.

    Heavy planning days — plotting passages, comparing anchorages, running

    through forecasts — can reach that limit, and Jules will let you know

    when you do. As you near the limit a "running low" banner appears

    above the input bar, showing how much of today's allowance you've used

    (for example 8.2k / 5k used) with a small gauge. When the day's

    allowance is spent, Jules dozes off — her

    octopus avatar closes its eyes with drifting Zzz in the chat header and

    on the tab bar — and wakes again at the next daily reset (or right away if

    you upgrade).

    AnchorQueen PRO and MAX raise the daily allowance substantially, so

    you can plan, ask, and explore all day without interruption. Upgrade any

    time from the Store; your higher allowance applies to Jules

    immediately.

    Suggestion chips

    Above the input bar, chips like "Is this anchorage safe?" or *"What's the

    weather?"* offer one-tap starting points that pick up your live position,

    weather, and boat state.

    Banners

    Three banners appear when relevant:

  • Offline — Jules needs a connection to answer; Saved Reports stay
  • readable.

  • Connection error — the last session failed; try again.
  • Engine fallback — the local inference engine was unavailable and a
  • cloud fallback was used.

    Long-press a message

    Long-press any message to Copy the text or Delete it.

    If you are not signed in

    Jules requires a captain account. When you are not signed in the chat is

    replaced by a sign-in screen — finish sign-in from the

    Captain tab and Jules will be ready.

    If something goes wrong

  • A reply never finishes — check connectivity; see
  • Troubleshooting: offline behavior.

  • Microphone does nothing — confirm Microphone access in iOS Settings.
  • Officers list is missing — tap Refresh Crew from the header menu.