ScriptSense
User Manual

Getting Started

Signing In

Navigate to scriptsense.akakala.com in any modern browser. Enter your email address and password, then click Sign in or press Enter.

After signing in, your name and institution appear in the left sidebar. ScriptSense remembers your session — you will stay signed in on the same device across browser sessions until you explicitly sign out.

Connecting Google Drive

Before approving your first transcription, connect your Google account so that approved work is saved automatically as Google Docs. Click Connect Google Drive in the bottom-left of the sidebar and follow the Google sign-in prompt. Once connected, the button changes to Google Drive connected.

You only need to do this once per device. If you sign into ScriptSense on a different computer, you will need to connect Google Drive on that device as well.

Dashboard

After signing in you land on the Dashboard — a grid of class cards. Each card shows the class name and type, the number of enrolled students and assignments, and spell/grammar chip indicators showing whether correction is currently on or off for that class.

Your account-level spell and grammar defaults are shown in the page header as a reference. The greeting at the top adapts to the time of day.

Click any class card to open the assignment list for that class.

Assignments

The Assignment view lists all assignments for the selected class. Each row shows the assignment type, name, due date, spell/grammar settings, and the number of submissions received. Click a row to open the student submission list for that assignment.

Creating an Assignment

Click + New assignment at the top right of the list and complete the dialog:

The spell and grammar settings you choose here become the default for every submission in this assignment. They can be overridden per student at upload time — see Spell & Grammar Controls.

Student Submissions

The Work List shows one row for every enrolled student in the selected assignment.

Students who have not yet submitted appear on a lightly shaded row. The + New submission button at the top of the list is disabled automatically once every enrolled student has a submission.

Uploading a Submission

Click Upload next to a student's name, or click + New submission at the top of the list to select any student who has not yet submitted.

1. Select the student from the dropdown. This is pre-selected if you clicked Upload directly on their row.

2. Add pages. Drag and drop files onto the drop zone, or click it to browse. Supported formats: JPEG, PNG, WEBP, PDF. Up to 20 pages per submission. Thumbnail previews appear below the drop zone as pages are added, and individual pages can be removed before uploading.

3. Check accommodation overrides. The spelling and grammar toggles start at the assignment's current settings. Adjust them here if this individual student needs different treatment — for example, turn spelling correction off for a student whose accommodation requires preserving their original spelling.

4. Click Upload & process.

ScriptSense saves the images immediately and queues the submission for processing. You will see a Queued badge right away. Processing begins within one minute and is typically complete within two to three minutes.

The Review Panel

When a submission is ready — status Needs Review — click Review to open the three-panel view. This is where you read the transcription, make any corrections, and approve the final text.

The top bar shows the student name, class, assignment, current status badge, correction count chips (once processing is complete), and the Save & approve button. A word-change counter updates in real time as you edit panel 3.

For multi-page submissions, numbered tabs appear above panel 1. Clicking a tab switches all three panels to that page simultaneously.

Either of the first two panels can be collapsed by clicking its title bar — this gives more room to the panels you are actively working with. Collapse preferences are saved across sessions.

Panel 1 — Original Image

The student's handwritten page displayed at full resolution. Use these controls to navigate:

Panel 2 — OCR Output

The raw text extracted by the OCR engine, displayed exactly as recognised — including misreads, broken words, and any formatting artefacts. This panel is read-only and is provided as a reference so you can see what Claude started from when producing its revision.

Panel 3 — Claude Transcription

The polished transcription produced by Claude AI. This is the text that will be saved to the student's record when you approve. The panel is fully editable — click anywhere to begin typing.

If spelling or grammar correction was on for this submission, correction count chips appear in the top bar once processing completes:

✓ 4 spell fixes ✓ 2 grammar fixes

The ↩ Reset button in the top bar discards your edits and restores Claude's original output at any point before you approve.

Approving a Transcription

When you are satisfied with the text in panel 3:

1. Make any edits you wish directly in panel 3.

2. Click Save & approve in the top bar.

ScriptSense will:

• Save your final text as the student's approved transcription
• Record any differences between Claude's output and your edits for future improvement
• Create a Google Doc in your Drive titled "[Student Name] — [Assignment Name]" and share it with the student as a commenter
• Return you to the Work List, where the student now shows Approved and an Open Doc ↗ link

Processing Status

Every submission moves through a sequence of statuses as it is processed. The current status appears in the Work List and in the review panel top bar.

Processing typically completes within two to three minutes of upload. The review panel updates automatically while processing — there is no need to refresh the page.

Spell & Grammar Controls

ScriptSense can instruct Claude to correct spelling errors, grammar errors, both, or neither. This is controlled at four levels. Each level inherits from the level above and can override it independently.

A green ✓ Spell chip indicates correction is on at that level. A grey chip indicates it is off. The chips appear on class cards, assignment rows, and the work list header.

When to turn correction off

Turn spelling or grammar correction off when you want to preserve the student's original writing exactly as written — for example, to assess writing mechanics directly, or to honour an accommodation that requires unmodified output. When both are off, Claude transcribes what the student wrote without changing any errors.

When to turn correction on

Turn correction on when the assignment focuses on content rather than writing mechanics — for example, a history essay where you need a clean, readable text to share with the student or include in academic records.

Administration

Users with the admin role see an Admin link in the left navigation sidebar. The Admin view has two tabs: Users and Usage & Costs.

Managing Users

The Users tab lists all accounts for your institution. Each row shows the person's name, email, role, default spell and grammar settings, last login date, and account status.

To add a user: Click + Add user and fill in the name, email, temporary password, role, and default spell/grammar settings. Share the temporary password with the user directly — they cannot reset it themselves during the pilot.

To edit a user: Click Edit on their row. You can update their name, reset their password, change their role, or disable their account. Disabling prevents login without deleting the user's data or history.

Usage & Costs

The Usage & Costs tab shows estimated API usage and operating costs for the selected month. Choose a month and click Load to refresh the data.

Adding a fixed cost: Enter a description and dollar amount in the fields below the summary cards and click + Add. This is useful for tracking hosting or subscription fees alongside API costs in a single view. Click Remove on any row to delete it.

Frequently Asked Questions