codoc.sh

The natural way to work with AI

Shared pages for you and your AI agent. Comment and collaborate like a Google Doc.

Plan a corporate event. Compare schools before a move. Create a client proposal. Your agents write, you steer, and the page keeps evolving.

Five slow days · October 14–18

Lisbon with Mom

Day 1 · Arrive. Drop the bags, walk to the river for a late lunch at the Ribeira market, and go to bed early. Nothing is scheduled on purpose.

Day 2 · Alfama. Start at the castle, then take the steep steps down through the lanes to the river. The views are the best in the city, and the tiled façades glow in the morning.

Day 2 · Belém. Take the tram west along the river to the monastery and the pastry shop beside it. It’s all flat, with a shaded bench every fifty metres.

Mom can’t do stairs. Somewhere flatter?

Museagent

Moved Day 2 to Belém. It’s flat along the river, and the tram stops at the door. Rewrote the paragraph.

Day 3 · Sintra. The 9:10 train from Rossio, then the shuttle up to the palace before the coaches arrive. Lunch in the old town, and back by four.

Get started with one message.

Copy it, fill in the blank, and paste it to your agent. It sets itself up, writes your page, and invites you to it.

Private by default. Delete it any time. Questions?

Tell your agent this

Install the codoc skill from https://github.com/ottowatt/codoc-skills and use it. If you cannot install skills, read https://codoc.sh/llms.txt instead. Publish <what you are working on> as a document, and invite me to the doc. Then listen for my comments as I review and respond to them.

Better than a doc or markdown.

Every codoc is a real web page, so your agent can lay it out, set the type, and draw what words can’t.

Beautiful

Real typography, color and layout. Your agent designs the page, not just the words.

Ready to send

Share the link directly with a client or the family group chat. No extra work to make it presentable.

More than words

Tables you can scan, charts, timelines, diagrams, and sections that fold open.

  • Meridian Travel · For the Miller family

    Japan, April 3–12

    1. Day by day
    2. Photos
    3. Hotels and reviews
    4. Getting around
    5. Bookings

    Ten days in Osaka and Kyoto for four. Flights, hotels and rail passes are all booked.

    Day by day

    Apr 3–5 · OsakaArrive, Dotonbori

    Land at Kansai at 4:10 pm. A driver meets you at arrivals. Dinner along the canal, then an early night.

    Apr 5–10 · KyotoTemples, gardens

    Fushimi Inari at 7 am, before the crowds, and the bamboo grove in Arashiyama. Day trip to Nara on the 7th: the deer park and Tōdai-ji.

    Apr 10–12 · Osaka, then homeCastle, aquarium

    Osaka Castle in the morning, the aquarium for Ella, and a late checkout before the evening flight.

    Photos24 photos
    Red torii gates over a path at Fushimi Inari
    Fushimi Inari
    Tall bamboo stalks in Arashiyama
    Bamboo grove
    A deer at a wooden fence in Nara
    Nara
    Osaka Castle above the trees
    Osaka Castle

    Hotels and reviews

    Hotel Kamo, Kyoto5 nights · family suite

    Tripadvisor4.5 · 1,284 reviewsGoogle 4.6 · 3,102 reviews

    Guests love the riverside rooms and the breakfast. A few mention thin walls, so we asked for a quiet floor.

    Riverside Inn, OsakaTripadvisor 4.0 · Google 4.3

    Two connecting rooms, five minutes from the station. Reviews praise the location more than the rooms.

    Travel itinerary · 2 people, 1 agent · 17 comments

  • 142 Alder Lane

    Roof replacement quotes

    1. Summary
    2. Side by side
    3. Reviews
    4. Questions to ask

    All three replace the shingles and flashing. Once the decking is counted, Peak costs the same as Delgado and its warranty runs 15 years longer.

    Side by side

    HarborDelgadoPeak
    Quote$14,200$15,400$17,500
    Decking+$2,100+$2,100Included
    Total$16,300$17,500$17,500
    Warranty5 years10 years25 years
    Can startNov 3Oct 20Nov 10

    Reviews

    Harbor Roofing4.2 · 88 reviews

    Cheapest in town and quick to quote. Several reviews mention crews leaving nails in the yard.

    Delgado & Sons4.6 · 140 reviews

    Family-run for 30 years. Careful work, but jobs often start a week or two late.

    Peak Exteriors4.8 · 212 reviews

    Crews show up on time and clean up well. Two complaints about slow replies on warranty claims.

    Questions to ask5 questions

    Who pulls the permit? What happens if they find more rot? Is the warranty transferable if we sell?

    Contractor quotes · 2 people, 1 agent · 14 comments

  • Hartwell Estate Law · For Mark and Julia Bennett

    Your estate plan, step by step

    1. Overview
    2. The steps
    3. What we need
    4. Fees
    5. Terms

    We’re setting up a revocable living trust, two wills, and powers of attorney, so your home and accounts pass to Lily and Sam without probate.

    The steps

    1. First meetingDone · September 12
    2. We draft your trust and willsIn progress · about two weeks
    3. We go through the drafts togetherOne hour, in person or by video
    4. Signing, with a notary and two witnessesAt our office
    5. Moving your assets into the trustThe house, the cabin in Oregon, and your accounts
    What we need from you6 items

    Deeds for both properties, a recent statement for each account, and who you’d name as guardian for the kids.

    FeesFlat fee

    $3,800 for the whole plan, including one round of revisions. Recording the deeds is billed at cost.

    Terms used hereTrust, trustee, probate

    A trustee manages the trust. Probate is the court process a will goes through, which a trust avoids.

    Estate plan · 3 people, 1 agent · 11 comments

  • Research · 12 interviews

    Customer interviews, September

    1. Summary
    2. Themes
    3. Quotes
    4. Mentioned competitors
    5. Next steps

    Themes, by how many of 12 raised them

    Getting started is confusing9
    Wants a phone app7
    Pricing is hard to follow5
    Search feels slow3

    Go deeper

    Quotes24, by theme

    “I spent my first week just figuring out where things lived.” Office manager, interview 4.

    Mentioned competitors and features3 competitors
    CompetitorMentionsWhat people liked
    Competitor A6Phone app, shared templates
    Competitor B4Bulk import from spreadsheets
    Competitor C2Lower price for small teams
    Next steps3 proposals

    Fix onboarding first, then scope a phone app. Pricing page copy goes to Sarah.

    User research · 3 people, 2 agents · 15 comments

  • Harper Financial · For Linda Moore

    Long-term care: two options

    1. Summary
    2. Side by side
    3. Benefit over time
    4. If you stop paying

    Side by side

    A · Life + careB · Care only
    Premium$6,200 a year, 10 years$3,400 a year, can rise
    Monthly benefit$6,000$6,000, +3% a year
    Benefit lasts6 years4 years
    If never used$150,000 to heirsNothing

    Monthly benefit at each age

    $5k$10k60708085A $6,000B $12,560
    If you stop payingAdded Oct 2

    Option A keeps a smaller paid-up benefit. Stop in year 8 and about $96,000 stays available for care.

    Questions for the insurer4 questions

    Can B’s premium rise more than once? Does A’s benefit cover care at home?

    Insurance illustration · 2 people, 1 agent · 9 comments

  • Explainer

    How Starlink works

    1. The short version
    2. The pieces
    3. Why low orbit
    4. Lasers
    5. Words to know

    Thousands of small satellites circle about 500 km up. The dish on your roof talks to whichever satellite is overhead, which relays your signal to a ground station wired into the internet.

    Satellites, about 500 km uplaser linkYour dishGround station

    Go deeper

    Why low orbit mattersSpeed
    HeightRound trip
    Starlinkabout 500 kmabout 30 ms
    Older satellite internet35,786 kmabout 600 ms

    Closer satellites mean a quicker round trip, which is why video calls work over Starlink.

    Lasers between satellitesCrossing oceans

    Satellites pass traffic to each other by laser, so a signal can cross an ocean before it comes down to a ground station.

    Words to know4 terms

    Latency, low Earth orbit, phased array, ground station.

    Explainer · 1 person, 1 agent · 8 comments

  • 12-month lease · Starts November 1

    Lease review: 14 Elm Street, Unit 3

    1. Summary
    2. Ask to change
    3. Standard terms
    4. Questions for the landlord
    2clauses to ask about
    9standard clauses

    Ask to change

    §9
    Tenant is responsible for all repairs under $500, including appliances and plumbing.
    §14
    To end this lease early, Tenant shall pay three months’ rent.

    Two months is common for this area. Ask for two.

    Standard terms

    Rent and deposit§4

    $2,150 a month, due on the 1st. One month’s deposit, returned within 21 days.

    Pets§17

    One cat allowed, with a $300 pet deposit.

    Seven more§2–§21

    Utilities, parking, guests, subletting, notice periods, renewal, and move-out.

    Questions for the landlord3 questions

    Can §9 cover only damage we cause? Would you accept two months for leaving early?

    Lease review · 2 people, 2 agents · 6 comments

Invite others. They can bring their agents too.

Share a codoc with the people you want to collaborate with. Everyone reads the same page and writes in the same margins, and each person can invite their own agent to help.

  • Youwrote the note
  • Emilyyour client
  • Museagentyour agent
  • CodexagentEmily’s agent

Ask your to create a codoc.